taglib-wasm 2.3.0 → 2.3.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 (633) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +70 -64
  3. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/assertClassBrand.js +7 -0
  4. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/checkPrivateRedeclaration.js +6 -0
  5. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/classPrivateFieldGet2.js +7 -0
  6. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/classPrivateFieldInitSpec.js +7 -0
  7. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/classPrivateFieldSet2.js +7 -0
  8. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/defineProperty.js +12 -0
  9. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/toPrimitive.js +14 -0
  10. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/toPropertyKey.js +9 -0
  11. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/typeof.js +11 -0
  12. package/dist/_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/usingCtx.js +57 -0
  13. package/dist/_virtual/_rolldown/runtime.js +13 -0
  14. package/dist/bwf/bext.d.ts.map +1 -0
  15. package/dist/bwf/bext.js +119 -0
  16. package/dist/{src/constants → constants}/additional-properties.d.ts.map +1 -1
  17. package/dist/constants/additional-properties.js +270 -0
  18. package/dist/constants/basic-properties.d.ts.map +1 -0
  19. package/dist/constants/basic-properties.js +128 -0
  20. package/dist/constants/complex-properties.d.ts.map +1 -0
  21. package/dist/constants/complex-properties.js +1 -0
  22. package/dist/constants/format-mappings.d.ts.map +1 -0
  23. package/dist/constants/format-mappings.js +58 -0
  24. package/dist/{src/constants → constants}/general-extended-properties.d.ts.map +1 -1
  25. package/dist/constants/general-extended-properties.js +272 -0
  26. package/dist/constants/index.d.ts.map +1 -0
  27. package/dist/constants/index.js +5 -0
  28. package/dist/{src/constants → constants}/properties.d.ts +1 -1
  29. package/dist/constants/properties.d.ts.map +1 -0
  30. package/dist/constants/properties.js +105 -0
  31. package/dist/constants/property-types.d.ts.map +1 -0
  32. package/dist/constants/property-types.js +1 -0
  33. package/dist/{src/constants → constants}/specialized-properties.d.ts.map +1 -1
  34. package/dist/constants/specialized-properties.js +335 -0
  35. package/dist/{src/constants → constants}/utilities.d.ts +1 -1
  36. package/dist/constants/utilities.d.ts.map +1 -0
  37. package/dist/constants/utilities.js +50 -0
  38. package/dist/constants.d.ts.map +1 -0
  39. package/dist/constants.js +5 -0
  40. package/dist/{src/deno-compile.d.ts → deno-compile.d.ts} +4 -2
  41. package/dist/deno-compile.d.ts.map +1 -0
  42. package/dist/deno-compile.js +109 -0
  43. package/dist/disc-folder.d.ts +4 -4
  44. package/dist/disc-folder.d.ts.map +1 -1
  45. package/dist/disc-folder.js +596 -544
  46. package/dist/errors/base.d.ts.map +1 -0
  47. package/dist/errors/base.js +66 -0
  48. package/dist/errors/classes.d.ts.map +1 -0
  49. package/dist/errors/classes.js +164 -0
  50. package/dist/errors/guards.d.ts.map +1 -0
  51. package/dist/errors/guards.js +26 -0
  52. package/dist/errors/index.d.ts.map +1 -0
  53. package/dist/errors/index.js +4 -0
  54. package/dist/errors.d.ts.map +1 -0
  55. package/dist/errors.js +5 -0
  56. package/dist/file-utils/copy-and-find.d.ts.map +1 -0
  57. package/dist/file-utils/copy-and-find.js +107 -0
  58. package/dist/file-utils/export-operations.d.ts.map +1 -0
  59. package/dist/file-utils/export-operations.js +84 -0
  60. package/dist/file-utils/import-operations.d.ts.map +1 -0
  61. package/dist/file-utils/import-operations.js +109 -0
  62. package/dist/file-utils/index.d.ts.map +1 -0
  63. package/dist/file-utils/index.js +5 -0
  64. package/dist/file-utils/mime-detection.d.ts.map +1 -0
  65. package/dist/file-utils/mime-detection.js +44 -0
  66. package/dist/folder-api/album-corroborate.d.ts.map +1 -0
  67. package/dist/folder-api/album-corroborate.js +35 -0
  68. package/dist/folder-api/album-discs.d.ts.map +1 -0
  69. package/dist/folder-api/album-discs.js +119 -0
  70. package/dist/folder-api/album-grouping.d.ts.map +1 -0
  71. package/dist/folder-api/album-grouping.js +161 -0
  72. package/dist/folder-api/album-identity.d.ts.map +1 -0
  73. package/dist/folder-api/album-identity.js +165 -0
  74. package/dist/folder-api/album-types.d.ts.map +1 -0
  75. package/dist/folder-api/album-types.js +1 -0
  76. package/dist/folder-api/directory-walker.d.ts.map +1 -0
  77. package/dist/folder-api/directory-walker.js +27 -0
  78. package/dist/folder-api/file-processors.d.ts.map +1 -0
  79. package/dist/folder-api/file-processors.js +52 -0
  80. package/dist/folder-api/folder-disc.d.ts.map +1 -0
  81. package/dist/folder-api/folder-disc.js +166 -0
  82. package/dist/folder-api/folder-operations.d.ts.map +1 -0
  83. package/dist/folder-api/folder-operations.js +69 -0
  84. package/dist/folder-api/index.d.ts.map +1 -0
  85. package/dist/{src/folder-api → folder-api}/index.js +1 -8
  86. package/dist/folder-api/scan-for-albums.d.ts.map +1 -0
  87. package/dist/folder-api/scan-for-albums.js +25 -0
  88. package/dist/folder-api/scan-operations.d.ts.map +1 -0
  89. package/dist/folder-api/scan-operations.js +79 -0
  90. package/dist/folder-api/types.d.ts.map +1 -0
  91. package/dist/folder-api/types.js +21 -0
  92. package/dist/folder.d.ts +1 -1
  93. package/dist/folder.d.ts.map +1 -1
  94. package/dist/folder.js +7 -2
  95. package/dist/global.d.js +1 -0
  96. package/dist/index.browser.d.ts +29 -30
  97. package/dist/index.browser.d.ts.map +1 -1
  98. package/dist/index.browser.js +4101 -4478
  99. package/dist/index.d.ts +26 -26
  100. package/dist/index.d.ts.map +1 -1
  101. package/dist/index.js +40 -185
  102. package/dist/msgpack/decoder.d.ts.map +1 -0
  103. package/dist/msgpack/decoder.js +177 -0
  104. package/dist/msgpack/encoder.d.ts.map +1 -0
  105. package/dist/msgpack/encoder.js +211 -0
  106. package/dist/msgpack/index.d.ts.map +1 -0
  107. package/dist/msgpack/index.js +5 -0
  108. package/dist/{src/msgpack → msgpack}/types.d.ts +1 -1
  109. package/dist/msgpack/types.d.ts.map +1 -0
  110. package/dist/msgpack/types.js +13 -0
  111. package/dist/msgpack/utils.d.ts.map +1 -0
  112. package/dist/msgpack/utils.js +116 -0
  113. package/dist/rating.d.ts +1 -1
  114. package/dist/rating.d.ts.map +1 -1
  115. package/dist/rating.js +2 -2
  116. package/dist/runtime/deno-detect.d.ts.map +1 -0
  117. package/dist/runtime/deno-detect.js +12 -0
  118. package/dist/{src/runtime → runtime}/detector.d.ts +2 -0
  119. package/dist/runtime/detector.d.ts.map +1 -0
  120. package/dist/runtime/detector.js +173 -0
  121. package/dist/runtime/loader-types.d.ts.map +1 -0
  122. package/dist/runtime/loader-types.js +23 -0
  123. package/dist/runtime/module-loader-browser.d.ts.map +1 -0
  124. package/dist/runtime/module-loader-browser.js +33 -0
  125. package/dist/runtime/module-loader.d.ts.map +1 -0
  126. package/dist/runtime/module-loader.js +119 -0
  127. package/dist/runtime/platform-io.d.ts.map +1 -0
  128. package/dist/runtime/platform-io.js +153 -0
  129. package/dist/runtime/unified-loader/index.d.ts.map +1 -0
  130. package/dist/{src/runtime → runtime}/unified-loader/index.js +1 -7
  131. package/dist/runtime/unified-loader/loader.d.ts.map +1 -0
  132. package/dist/runtime/unified-loader/loader.js +64 -0
  133. package/dist/runtime/unified-loader/module-loading.d.ts.map +1 -0
  134. package/dist/runtime/unified-loader/module-loading.js +90 -0
  135. package/dist/runtime/unified-loader/module-selection.d.ts.map +1 -0
  136. package/dist/runtime/unified-loader/module-selection.js +25 -0
  137. package/dist/runtime/unified-loader/types.d.ts.map +1 -0
  138. package/dist/runtime/unified-loader/types.js +24 -0
  139. package/dist/runtime/wasi-adapter/adapter.d.ts.map +1 -0
  140. package/dist/runtime/wasi-adapter/adapter.js +114 -0
  141. package/dist/runtime/wasi-adapter/audio-properties.d.ts.map +1 -0
  142. package/dist/runtime/wasi-adapter/audio-properties.js +120 -0
  143. package/dist/runtime/wasi-adapter/file-handle.d.ts.map +1 -0
  144. package/dist/runtime/wasi-adapter/file-handle.js +181 -0
  145. package/dist/runtime/wasi-adapter/handle-state.d.ts.map +1 -0
  146. package/dist/runtime/wasi-adapter/handle-state.js +48 -0
  147. package/dist/runtime/wasi-adapter/index.d.ts.map +1 -0
  148. package/dist/{src/runtime → runtime}/wasi-adapter/index.js +1 -3
  149. package/dist/runtime/wasi-adapter/mp4-items.d.ts.map +1 -0
  150. package/dist/runtime/wasi-adapter/mp4-items.js +97 -0
  151. package/dist/runtime/wasi-adapter/path-open.d.ts.map +1 -0
  152. package/dist/runtime/wasi-adapter/path-open.js +101 -0
  153. package/dist/runtime/wasi-adapter/property-surface.d.ts.map +1 -0
  154. package/dist/runtime/wasi-adapter/property-surface.js +96 -0
  155. package/dist/runtime/wasi-adapter/structured-fields.d.ts.map +1 -0
  156. package/dist/runtime/wasi-adapter/structured-fields.js +144 -0
  157. package/dist/runtime/wasi-adapter/tag-keys.d.ts.map +1 -0
  158. package/dist/runtime/wasi-adapter/tag-keys.js +65 -0
  159. package/dist/runtime/wasi-adapter/wasm-io.d.ts.map +1 -0
  160. package/dist/runtime/wasi-adapter/wasm-io.js +154 -0
  161. package/dist/runtime/wasi-fs-deno.d.ts.map +1 -0
  162. package/dist/runtime/wasi-fs-deno.js +25 -0
  163. package/dist/runtime/wasi-fs-node.d.ts.map +1 -0
  164. package/dist/runtime/wasi-fs-node.js +58 -0
  165. package/dist/runtime/wasi-fs-provider.d.ts.map +1 -0
  166. package/dist/runtime/wasi-fs-provider.js +1 -0
  167. package/dist/runtime/wasi-host-loader.d.ts.map +1 -0
  168. package/dist/runtime/wasi-host-loader.js +101 -0
  169. package/dist/runtime/wasi-host.d.ts.map +1 -0
  170. package/dist/runtime/wasi-host.js +199 -0
  171. package/dist/runtime/wasi-memory.d.ts.map +1 -0
  172. package/dist/runtime/wasi-memory.js +179 -0
  173. package/dist/runtime/wasmer-sdk-loader/types.d.ts.map +1 -0
  174. package/dist/runtime/wasmer-sdk-loader/types.js +15 -0
  175. package/dist/simple/batch-operations.d.ts.map +1 -0
  176. package/dist/simple/batch-operations.js +245 -0
  177. package/dist/simple/checksum-operations.d.ts.map +1 -0
  178. package/dist/simple/checksum-operations.js +28 -0
  179. package/dist/simple/config.d.ts.map +1 -0
  180. package/dist/simple/config.js +17 -0
  181. package/dist/simple/index.d.ts.map +1 -0
  182. package/dist/simple/index.js +8 -0
  183. package/dist/simple/picture-operations.d.ts.map +1 -0
  184. package/dist/simple/picture-operations.js +132 -0
  185. package/dist/simple/tag-operations.d.ts.map +1 -0
  186. package/dist/simple/tag-operations.js +125 -0
  187. package/dist/simple/with-audio-file.d.ts.map +1 -0
  188. package/dist/simple/with-audio-file.js +28 -0
  189. package/dist/simple.browser.d.ts +2 -2
  190. package/dist/simple.browser.d.ts.map +1 -1
  191. package/dist/simple.browser.js +3404 -3692
  192. package/dist/simple.d.ts +1 -1
  193. package/dist/simple.d.ts.map +1 -1
  194. package/dist/simple.js +8 -2
  195. package/dist/taglib/audio-file-base.d.ts.map +1 -0
  196. package/dist/taglib/audio-file-base.js +166 -0
  197. package/dist/taglib/audio-file-bwf.d.ts.map +1 -0
  198. package/dist/taglib/audio-file-bwf.js +33 -0
  199. package/dist/taglib/audio-file-checksum.d.ts.map +1 -0
  200. package/dist/taglib/audio-file-checksum.js +90 -0
  201. package/dist/taglib/audio-file-impl.d.ts.map +1 -0
  202. package/dist/taglib/audio-file-impl.js +234 -0
  203. package/dist/taglib/audio-file-interface.d.ts.map +1 -0
  204. package/dist/taglib/audio-file-interface.js +1 -0
  205. package/dist/taglib/auto-dispose.d.ts.map +1 -0
  206. package/dist/taglib/auto-dispose.js +34 -0
  207. package/dist/taglib/embind-adapter.d.ts.map +1 -0
  208. package/dist/taglib/embind-adapter.js +137 -0
  209. package/dist/taglib/extra-state-registry.d.ts.map +1 -0
  210. package/dist/taglib/extra-state-registry.js +72 -0
  211. package/dist/{src/taglib → taglib}/id3v2-frames.d.ts +0 -1
  212. package/dist/taglib/id3v2-frames.d.ts.map +1 -0
  213. package/dist/taglib/id3v2-frames.js +25 -0
  214. package/dist/taglib/index.d.ts.map +1 -0
  215. package/dist/taglib/index.js +7 -0
  216. package/dist/taglib/load-audio-data.d.ts.map +1 -0
  217. package/dist/taglib/load-audio-data.js +54 -0
  218. package/dist/taglib/media-ranges.d.ts.map +1 -0
  219. package/dist/taglib/media-ranges.js +309 -0
  220. package/dist/taglib/metadata-extent.d.ts.map +1 -0
  221. package/dist/taglib/metadata-extent.js +394 -0
  222. package/dist/taglib/mp4-item-names.d.ts.map +1 -0
  223. package/dist/taglib/mp4-item-names.js +14 -0
  224. package/dist/taglib/mutable-tag-impl.d.ts.map +1 -0
  225. package/dist/taglib/mutable-tag-impl.js +81 -0
  226. package/dist/taglib/mutable-tag.d.ts.map +1 -0
  227. package/dist/taglib/mutable-tag.js +1 -0
  228. package/dist/taglib/save-reconstruct.d.ts.map +1 -0
  229. package/dist/taglib/save-reconstruct.js +53 -0
  230. package/dist/taglib/taglib-class.d.ts.map +1 -0
  231. package/dist/taglib/taglib-class.js +146 -0
  232. package/dist/taglib-wrapper.js +1 -1
  233. package/dist/taglib.d.ts.map +1 -0
  234. package/dist/taglib.js +7 -0
  235. package/dist/types/audio-formats.d.ts.map +1 -0
  236. package/dist/types/audio-formats.js +6 -0
  237. package/dist/types/bwf.d.ts.map +1 -0
  238. package/dist/types/bwf.js +1 -0
  239. package/dist/types/chapters.d.ts.map +1 -0
  240. package/dist/types/chapters.js +1 -0
  241. package/dist/types/config.d.ts.map +1 -0
  242. package/dist/types/config.js +1 -0
  243. package/dist/types/format-property-keys.d.ts.map +1 -0
  244. package/dist/types/format-property-keys.js +1 -0
  245. package/dist/types/index.d.ts.map +1 -0
  246. package/dist/types/index.js +9 -0
  247. package/dist/types/metadata-mappings.d.ts.map +1 -0
  248. package/dist/types/metadata-mappings.js +323 -0
  249. package/dist/types/pictures.d.ts.map +1 -0
  250. package/dist/types/pictures.js +79 -0
  251. package/dist/types/tags.d.ts.map +1 -0
  252. package/dist/types/tags.js +1 -0
  253. package/dist/types.d.ts.map +1 -0
  254. package/dist/types.js +5 -0
  255. package/dist/utils/file.d.ts.map +1 -0
  256. package/dist/utils/file.js +43 -0
  257. package/dist/utils/mirror-fields.d.ts.map +1 -0
  258. package/dist/utils/mirror-fields.js +107 -0
  259. package/dist/utils/node-fs.d.ts.map +1 -0
  260. package/dist/utils/node-fs.js +36 -0
  261. package/dist/utils/path.d.ts.map +1 -0
  262. package/dist/utils/path.js +52 -0
  263. package/dist/utils/rating.d.ts.map +1 -0
  264. package/dist/utils/rating.js +150 -0
  265. package/dist/utils/tag-mapping.d.ts.map +1 -0
  266. package/dist/utils/tag-mapping.js +207 -0
  267. package/dist/utils/write.d.ts.map +1 -0
  268. package/dist/utils/write.js +18 -0
  269. package/dist/version.d.ts +2 -0
  270. package/dist/version.d.ts.map +1 -0
  271. package/dist/version.js +4 -0
  272. package/dist/wasm.d.ts.map +1 -0
  273. package/dist/wasm.js +1 -0
  274. package/dist/web-utils/canvas.d.ts.map +1 -0
  275. package/dist/web-utils/canvas.js +97 -0
  276. package/dist/web-utils/data-url.d.ts.map +1 -0
  277. package/dist/web-utils/data-url.js +54 -0
  278. package/dist/web-utils/dom-integration.d.ts.map +1 -0
  279. package/dist/web-utils/dom-integration.js +105 -0
  280. package/dist/web-utils/index.d.ts.map +1 -0
  281. package/dist/web-utils/index.js +4 -0
  282. package/dist/web.browser.d.ts +5 -5
  283. package/dist/web.browser.d.ts.map +1 -1
  284. package/dist/web.browser.js +3168 -3411
  285. package/dist/web.d.ts +1 -1
  286. package/dist/web.d.ts.map +1 -1
  287. package/dist/web.js +5 -2
  288. package/package.json +131 -96
  289. package/dist/src/bwf/bext.d.ts.map +0 -1
  290. package/dist/src/bwf/bext.js +0 -126
  291. package/dist/src/constants/additional-properties.js +0 -204
  292. package/dist/src/constants/basic-properties.d.ts.map +0 -1
  293. package/dist/src/constants/basic-properties.js +0 -89
  294. package/dist/src/constants/complex-properties.d.ts.map +0 -1
  295. package/dist/src/constants/complex-properties.js +0 -0
  296. package/dist/src/constants/format-mappings.d.ts.map +0 -1
  297. package/dist/src/constants/format-mappings.js +0 -54
  298. package/dist/src/constants/general-extended-properties.js +0 -254
  299. package/dist/src/constants/index.d.ts.map +0 -1
  300. package/dist/src/constants/index.js +0 -4
  301. package/dist/src/constants/properties.d.ts.map +0 -1
  302. package/dist/src/constants/properties.js +0 -95
  303. package/dist/src/constants/property-types.d.ts.map +0 -1
  304. package/dist/src/constants/property-types.js +0 -0
  305. package/dist/src/constants/specialized-properties.js +0 -223
  306. package/dist/src/constants/utilities.d.ts.map +0 -1
  307. package/dist/src/constants/utilities.js +0 -33
  308. package/dist/src/constants.d.ts.map +0 -1
  309. package/dist/src/constants.js +0 -1
  310. package/dist/src/deno-compile.d.ts.map +0 -1
  311. package/dist/src/deno-compile.js +0 -75
  312. package/dist/src/errors/base.d.ts.map +0 -1
  313. package/dist/src/errors/base.js +0 -49
  314. package/dist/src/errors/classes.d.ts.map +0 -1
  315. package/dist/src/errors/classes.js +0 -170
  316. package/dist/src/errors/guards.d.ts.map +0 -1
  317. package/dist/src/errors/guards.js +0 -39
  318. package/dist/src/errors/index.d.ts.map +0 -1
  319. package/dist/src/errors/index.js +0 -39
  320. package/dist/src/errors.d.ts.map +0 -1
  321. package/dist/src/errors.js +0 -1
  322. package/dist/src/file-utils/copy-and-find.d.ts.map +0 -1
  323. package/dist/src/file-utils/copy-and-find.js +0 -89
  324. package/dist/src/file-utils/export-operations.d.ts.map +0 -1
  325. package/dist/src/file-utils/export-operations.js +0 -40
  326. package/dist/src/file-utils/import-operations.d.ts.map +0 -1
  327. package/dist/src/file-utils/import-operations.js +0 -42
  328. package/dist/src/file-utils/index.d.ts.map +0 -1
  329. package/dist/src/file-utils/index.js +0 -26
  330. package/dist/src/file-utils/mime-detection.d.ts.map +0 -1
  331. package/dist/src/file-utils/mime-detection.js +0 -45
  332. package/dist/src/folder-api/album-corroborate.d.ts.map +0 -1
  333. package/dist/src/folder-api/album-corroborate.js +0 -36
  334. package/dist/src/folder-api/album-discs.d.ts.map +0 -1
  335. package/dist/src/folder-api/album-discs.js +0 -122
  336. package/dist/src/folder-api/album-grouping.d.ts.map +0 -1
  337. package/dist/src/folder-api/album-grouping.js +0 -118
  338. package/dist/src/folder-api/album-identity.d.ts.map +0 -1
  339. package/dist/src/folder-api/album-identity.js +0 -151
  340. package/dist/src/folder-api/album-types.d.ts.map +0 -1
  341. package/dist/src/folder-api/album-types.js +0 -0
  342. package/dist/src/folder-api/directory-walker.d.ts.map +0 -1
  343. package/dist/src/folder-api/directory-walker.js +0 -35
  344. package/dist/src/folder-api/file-processors.d.ts.map +0 -1
  345. package/dist/src/folder-api/file-processors.js +0 -63
  346. package/dist/src/folder-api/folder-disc.d.ts.map +0 -1
  347. package/dist/src/folder-api/folder-disc.js +0 -169
  348. package/dist/src/folder-api/folder-operations.d.ts.map +0 -1
  349. package/dist/src/folder-api/folder-operations.js +0 -54
  350. package/dist/src/folder-api/index.d.ts.map +0 -1
  351. package/dist/src/folder-api/scan-for-albums.d.ts.map +0 -1
  352. package/dist/src/folder-api/scan-for-albums.js +0 -20
  353. package/dist/src/folder-api/scan-operations.d.ts.map +0 -1
  354. package/dist/src/folder-api/scan-operations.js +0 -77
  355. package/dist/src/folder-api/types.d.ts.map +0 -1
  356. package/dist/src/folder-api/types.js +0 -21
  357. package/dist/src/msgpack/decoder.d.ts.map +0 -1
  358. package/dist/src/msgpack/decoder.js +0 -215
  359. package/dist/src/msgpack/encoder.d.ts.map +0 -1
  360. package/dist/src/msgpack/encoder.js +0 -249
  361. package/dist/src/msgpack/index.d.ts.map +0 -1
  362. package/dist/src/msgpack/index.js +0 -56
  363. package/dist/src/msgpack/types.d.ts.map +0 -1
  364. package/dist/src/msgpack/types.js +0 -12
  365. package/dist/src/msgpack/utils.d.ts.map +0 -1
  366. package/dist/src/msgpack/utils.js +0 -134
  367. package/dist/src/runtime/deno-detect.d.ts.map +0 -1
  368. package/dist/src/runtime/deno-detect.js +0 -6
  369. package/dist/src/runtime/detector.d.ts.map +0 -1
  370. package/dist/src/runtime/detector.js +0 -181
  371. package/dist/src/runtime/loader-types.d.ts.map +0 -1
  372. package/dist/src/runtime/loader-types.js +0 -10
  373. package/dist/src/runtime/module-loader-browser.d.ts.map +0 -1
  374. package/dist/src/runtime/module-loader-browser.js +0 -37
  375. package/dist/src/runtime/module-loader.d.ts.map +0 -1
  376. package/dist/src/runtime/module-loader.js +0 -119
  377. package/dist/src/runtime/platform-io.d.ts.map +0 -1
  378. package/dist/src/runtime/platform-io.js +0 -188
  379. package/dist/src/runtime/unified-loader/index.d.ts.map +0 -1
  380. package/dist/src/runtime/unified-loader/loader.d.ts.map +0 -1
  381. package/dist/src/runtime/unified-loader/loader.js +0 -84
  382. package/dist/src/runtime/unified-loader/module-loading.d.ts.map +0 -1
  383. package/dist/src/runtime/unified-loader/module-loading.js +0 -122
  384. package/dist/src/runtime/unified-loader/module-selection.d.ts.map +0 -1
  385. package/dist/src/runtime/unified-loader/module-selection.js +0 -41
  386. package/dist/src/runtime/unified-loader/types.d.ts.map +0 -1
  387. package/dist/src/runtime/unified-loader/types.js +0 -25
  388. package/dist/src/runtime/wasi-adapter/adapter.d.ts.map +0 -1
  389. package/dist/src/runtime/wasi-adapter/adapter.js +0 -130
  390. package/dist/src/runtime/wasi-adapter/audio-properties.d.ts.map +0 -1
  391. package/dist/src/runtime/wasi-adapter/audio-properties.js +0 -102
  392. package/dist/src/runtime/wasi-adapter/file-handle.d.ts.map +0 -1
  393. package/dist/src/runtime/wasi-adapter/file-handle.js +0 -197
  394. package/dist/src/runtime/wasi-adapter/handle-state.d.ts.map +0 -1
  395. package/dist/src/runtime/wasi-adapter/handle-state.js +0 -58
  396. package/dist/src/runtime/wasi-adapter/index.d.ts.map +0 -1
  397. package/dist/src/runtime/wasi-adapter/mp4-items.d.ts.map +0 -1
  398. package/dist/src/runtime/wasi-adapter/mp4-items.js +0 -80
  399. package/dist/src/runtime/wasi-adapter/path-open.d.ts.map +0 -1
  400. package/dist/src/runtime/wasi-adapter/path-open.js +0 -76
  401. package/dist/src/runtime/wasi-adapter/property-surface.d.ts.map +0 -1
  402. package/dist/src/runtime/wasi-adapter/property-surface.js +0 -104
  403. package/dist/src/runtime/wasi-adapter/structured-fields.d.ts.map +0 -1
  404. package/dist/src/runtime/wasi-adapter/structured-fields.js +0 -139
  405. package/dist/src/runtime/wasi-adapter/tag-keys.d.ts.map +0 -1
  406. package/dist/src/runtime/wasi-adapter/tag-keys.js +0 -46
  407. package/dist/src/runtime/wasi-adapter/wasm-io.d.ts.map +0 -1
  408. package/dist/src/runtime/wasi-adapter/wasm-io.js +0 -257
  409. package/dist/src/runtime/wasi-fs-deno.d.ts.map +0 -1
  410. package/dist/src/runtime/wasi-fs-deno.js +0 -26
  411. package/dist/src/runtime/wasi-fs-node.d.ts.map +0 -1
  412. package/dist/src/runtime/wasi-fs-node.js +0 -66
  413. package/dist/src/runtime/wasi-fs-provider.d.ts.map +0 -1
  414. package/dist/src/runtime/wasi-fs-provider.js +0 -0
  415. package/dist/src/runtime/wasi-host-loader.d.ts.map +0 -1
  416. package/dist/src/runtime/wasi-host-loader.js +0 -114
  417. package/dist/src/runtime/wasi-host.d.ts.map +0 -1
  418. package/dist/src/runtime/wasi-host.js +0 -202
  419. package/dist/src/runtime/wasi-memory.d.ts.map +0 -1
  420. package/dist/src/runtime/wasi-memory.js +0 -197
  421. package/dist/src/runtime/wasmer-sdk-loader/types.d.ts.map +0 -1
  422. package/dist/src/runtime/wasmer-sdk-loader/types.js +0 -12
  423. package/dist/src/simple/batch-operations.d.ts.map +0 -1
  424. package/dist/src/simple/batch-operations.js +0 -186
  425. package/dist/src/simple/checksum-operations.d.ts.map +0 -1
  426. package/dist/src/simple/checksum-operations.js +0 -7
  427. package/dist/src/simple/config.d.ts.map +0 -1
  428. package/dist/src/simple/config.js +0 -18
  429. package/dist/src/simple/index.d.ts.map +0 -1
  430. package/dist/src/simple/index.js +0 -60
  431. package/dist/src/simple/picture-operations.d.ts.map +0 -1
  432. package/dist/src/simple/picture-operations.js +0 -68
  433. package/dist/src/simple/tag-operations.d.ts.map +0 -1
  434. package/dist/src/simple/tag-operations.js +0 -90
  435. package/dist/src/simple/with-audio-file.d.ts.map +0 -1
  436. package/dist/src/simple/with-audio-file.js +0 -39
  437. package/dist/src/taglib/audio-file-base.d.ts.map +0 -1
  438. package/dist/src/taglib/audio-file-base.js +0 -187
  439. package/dist/src/taglib/audio-file-bwf.d.ts.map +0 -1
  440. package/dist/src/taglib/audio-file-bwf.js +0 -41
  441. package/dist/src/taglib/audio-file-checksum.d.ts.map +0 -1
  442. package/dist/src/taglib/audio-file-checksum.js +0 -77
  443. package/dist/src/taglib/audio-file-impl.d.ts.map +0 -1
  444. package/dist/src/taglib/audio-file-impl.js +0 -317
  445. package/dist/src/taglib/audio-file-interface.d.ts.map +0 -1
  446. package/dist/src/taglib/audio-file-interface.js +0 -0
  447. package/dist/src/taglib/auto-dispose.d.ts.map +0 -1
  448. package/dist/src/taglib/auto-dispose.js +0 -13
  449. package/dist/src/taglib/embind-adapter.d.ts.map +0 -1
  450. package/dist/src/taglib/embind-adapter.js +0 -141
  451. package/dist/src/taglib/extra-state-registry.d.ts.map +0 -1
  452. package/dist/src/taglib/extra-state-registry.js +0 -78
  453. package/dist/src/taglib/id3v2-frames.d.ts.map +0 -1
  454. package/dist/src/taglib/id3v2-frames.js +0 -42
  455. package/dist/src/taglib/index.d.ts.map +0 -1
  456. package/dist/src/taglib/index.js +0 -41
  457. package/dist/src/taglib/load-audio-data.d.ts.map +0 -1
  458. package/dist/src/taglib/load-audio-data.js +0 -51
  459. package/dist/src/taglib/media-ranges.d.ts.map +0 -1
  460. package/dist/src/taglib/media-ranges.js +0 -192
  461. package/dist/src/taglib/metadata-extent.d.ts.map +0 -1
  462. package/dist/src/taglib/metadata-extent.js +0 -189
  463. package/dist/src/taglib/mp4-item-names.d.ts.map +0 -1
  464. package/dist/src/taglib/mp4-item-names.js +0 -4
  465. package/dist/src/taglib/mutable-tag-impl.d.ts.map +0 -1
  466. package/dist/src/taglib/mutable-tag-impl.js +0 -88
  467. package/dist/src/taglib/mutable-tag.d.ts.map +0 -1
  468. package/dist/src/taglib/mutable-tag.js +0 -0
  469. package/dist/src/taglib/save-reconstruct.d.ts.map +0 -1
  470. package/dist/src/taglib/save-reconstruct.js +0 -43
  471. package/dist/src/taglib/taglib-class.d.ts.map +0 -1
  472. package/dist/src/taglib/taglib-class.js +0 -195
  473. package/dist/src/taglib.d.ts.map +0 -1
  474. package/dist/src/taglib.js +0 -1
  475. package/dist/src/types/audio-formats.d.ts.map +0 -1
  476. package/dist/src/types/audio-formats.js +0 -6
  477. package/dist/src/types/bwf.d.ts.map +0 -1
  478. package/dist/src/types/bwf.js +0 -0
  479. package/dist/src/types/chapters.d.ts.map +0 -1
  480. package/dist/src/types/chapters.js +0 -0
  481. package/dist/src/types/config.d.ts.map +0 -1
  482. package/dist/src/types/config.js +0 -0
  483. package/dist/src/types/format-property-keys.d.ts.map +0 -1
  484. package/dist/src/types/format-property-keys.js +0 -0
  485. package/dist/src/types/index.d.ts.map +0 -1
  486. package/dist/src/types/index.js +0 -8
  487. package/dist/src/types/metadata-mappings.d.ts.map +0 -1
  488. package/dist/src/types/metadata-mappings.js +0 -252
  489. package/dist/src/types/pictures.d.ts.map +0 -1
  490. package/dist/src/types/pictures.js +0 -64
  491. package/dist/src/types/tags.d.ts.map +0 -1
  492. package/dist/src/types/tags.js +0 -0
  493. package/dist/src/types.d.ts.map +0 -1
  494. package/dist/src/types.js +0 -1
  495. package/dist/src/utils/file.d.ts.map +0 -1
  496. package/dist/src/utils/file.js +0 -52
  497. package/dist/src/utils/mirror-fields.d.ts.map +0 -1
  498. package/dist/src/utils/mirror-fields.js +0 -75
  499. package/dist/src/utils/node-fs.d.ts.map +0 -1
  500. package/dist/src/utils/node-fs.js +0 -22
  501. package/dist/src/utils/path.d.ts.map +0 -1
  502. package/dist/src/utils/path.js +0 -36
  503. package/dist/src/utils/rating.d.ts.map +0 -1
  504. package/dist/src/utils/rating.js +0 -73
  505. package/dist/src/utils/tag-mapping.d.ts.map +0 -1
  506. package/dist/src/utils/tag-mapping.js +0 -214
  507. package/dist/src/utils/write.d.ts.map +0 -1
  508. package/dist/src/utils/write.js +0 -17
  509. package/dist/src/version.d.ts +0 -2
  510. package/dist/src/version.d.ts.map +0 -1
  511. package/dist/src/version.js +0 -4
  512. package/dist/src/wasm.d.ts.map +0 -1
  513. package/dist/src/wasm.js +0 -0
  514. package/dist/src/web-utils/canvas.d.ts.map +0 -1
  515. package/dist/src/web-utils/canvas.js +0 -60
  516. package/dist/src/web-utils/data-url.d.ts.map +0 -1
  517. package/dist/src/web-utils/data-url.js +0 -34
  518. package/dist/src/web-utils/dom-integration.d.ts.map +0 -1
  519. package/dist/src/web-utils/dom-integration.js +0 -53
  520. package/dist/src/web-utils/index.d.ts.map +0 -1
  521. package/dist/src/web-utils/index.js +0 -21
  522. /package/dist/{src/bwf → bwf}/bext.d.ts +0 -0
  523. /package/dist/{src/constants → constants}/additional-properties.d.ts +0 -0
  524. /package/dist/{src/constants → constants}/basic-properties.d.ts +0 -0
  525. /package/dist/{src/constants → constants}/complex-properties.d.ts +0 -0
  526. /package/dist/{src/constants → constants}/format-mappings.d.ts +0 -0
  527. /package/dist/{src/constants → constants}/general-extended-properties.d.ts +0 -0
  528. /package/dist/{src/constants → constants}/index.d.ts +0 -0
  529. /package/dist/{src/constants → constants}/property-types.d.ts +0 -0
  530. /package/dist/{src/constants → constants}/specialized-properties.d.ts +0 -0
  531. /package/dist/{src/constants.d.ts → constants.d.ts} +0 -0
  532. /package/dist/{src/errors → errors}/base.d.ts +0 -0
  533. /package/dist/{src/errors → errors}/classes.d.ts +0 -0
  534. /package/dist/{src/errors → errors}/guards.d.ts +0 -0
  535. /package/dist/{src/errors → errors}/index.d.ts +0 -0
  536. /package/dist/{src/errors.d.ts → errors.d.ts} +0 -0
  537. /package/dist/{src/file-utils → file-utils}/copy-and-find.d.ts +0 -0
  538. /package/dist/{src/file-utils → file-utils}/export-operations.d.ts +0 -0
  539. /package/dist/{src/file-utils → file-utils}/import-operations.d.ts +0 -0
  540. /package/dist/{src/file-utils → file-utils}/index.d.ts +0 -0
  541. /package/dist/{src/file-utils → file-utils}/mime-detection.d.ts +0 -0
  542. /package/dist/{src/folder-api → folder-api}/album-corroborate.d.ts +0 -0
  543. /package/dist/{src/folder-api → folder-api}/album-discs.d.ts +0 -0
  544. /package/dist/{src/folder-api → folder-api}/album-grouping.d.ts +0 -0
  545. /package/dist/{src/folder-api → folder-api}/album-identity.d.ts +0 -0
  546. /package/dist/{src/folder-api → folder-api}/album-types.d.ts +0 -0
  547. /package/dist/{src/folder-api → folder-api}/directory-walker.d.ts +0 -0
  548. /package/dist/{src/folder-api → folder-api}/file-processors.d.ts +0 -0
  549. /package/dist/{src/folder-api → folder-api}/folder-disc.d.ts +0 -0
  550. /package/dist/{src/folder-api → folder-api}/folder-operations.d.ts +0 -0
  551. /package/dist/{src/folder-api → folder-api}/index.d.ts +0 -0
  552. /package/dist/{src/folder-api → folder-api}/scan-for-albums.d.ts +0 -0
  553. /package/dist/{src/folder-api → folder-api}/scan-operations.d.ts +0 -0
  554. /package/dist/{src/folder-api → folder-api}/types.d.ts +0 -0
  555. /package/dist/{src/msgpack → msgpack}/decoder.d.ts +0 -0
  556. /package/dist/{src/msgpack → msgpack}/encoder.d.ts +0 -0
  557. /package/dist/{src/msgpack → msgpack}/index.d.ts +0 -0
  558. /package/dist/{src/msgpack → msgpack}/utils.d.ts +0 -0
  559. /package/dist/{src/runtime → runtime}/deno-detect.d.ts +0 -0
  560. /package/dist/{src/runtime → runtime}/loader-types.d.ts +0 -0
  561. /package/dist/{src/runtime → runtime}/module-loader-browser.d.ts +0 -0
  562. /package/dist/{src/runtime → runtime}/module-loader.d.ts +0 -0
  563. /package/dist/{src/runtime → runtime}/platform-io.d.ts +0 -0
  564. /package/dist/{src/runtime → runtime}/unified-loader/index.d.ts +0 -0
  565. /package/dist/{src/runtime → runtime}/unified-loader/loader.d.ts +0 -0
  566. /package/dist/{src/runtime → runtime}/unified-loader/module-loading.d.ts +0 -0
  567. /package/dist/{src/runtime → runtime}/unified-loader/module-selection.d.ts +0 -0
  568. /package/dist/{src/runtime → runtime}/unified-loader/types.d.ts +0 -0
  569. /package/dist/{src/runtime → runtime}/wasi-adapter/adapter.d.ts +0 -0
  570. /package/dist/{src/runtime → runtime}/wasi-adapter/audio-properties.d.ts +0 -0
  571. /package/dist/{src/runtime → runtime}/wasi-adapter/file-handle.d.ts +0 -0
  572. /package/dist/{src/runtime → runtime}/wasi-adapter/handle-state.d.ts +0 -0
  573. /package/dist/{src/runtime → runtime}/wasi-adapter/index.d.ts +0 -0
  574. /package/dist/{src/runtime → runtime}/wasi-adapter/mp4-items.d.ts +0 -0
  575. /package/dist/{src/runtime → runtime}/wasi-adapter/path-open.d.ts +0 -0
  576. /package/dist/{src/runtime → runtime}/wasi-adapter/property-surface.d.ts +0 -0
  577. /package/dist/{src/runtime → runtime}/wasi-adapter/structured-fields.d.ts +0 -0
  578. /package/dist/{src/runtime → runtime}/wasi-adapter/tag-keys.d.ts +0 -0
  579. /package/dist/{src/runtime → runtime}/wasi-adapter/wasm-io.d.ts +0 -0
  580. /package/dist/{src/runtime → runtime}/wasi-fs-deno.d.ts +0 -0
  581. /package/dist/{src/runtime → runtime}/wasi-fs-node.d.ts +0 -0
  582. /package/dist/{src/runtime → runtime}/wasi-fs-provider.d.ts +0 -0
  583. /package/dist/{src/runtime → runtime}/wasi-host-loader.d.ts +0 -0
  584. /package/dist/{src/runtime → runtime}/wasi-host.d.ts +0 -0
  585. /package/dist/{src/runtime → runtime}/wasi-memory.d.ts +0 -0
  586. /package/dist/{src/runtime → runtime}/wasmer-sdk-loader/types.d.ts +0 -0
  587. /package/dist/{src/simple → simple}/batch-operations.d.ts +0 -0
  588. /package/dist/{src/simple → simple}/checksum-operations.d.ts +0 -0
  589. /package/dist/{src/simple → simple}/config.d.ts +0 -0
  590. /package/dist/{src/simple → simple}/index.d.ts +0 -0
  591. /package/dist/{src/simple → simple}/picture-operations.d.ts +0 -0
  592. /package/dist/{src/simple → simple}/tag-operations.d.ts +0 -0
  593. /package/dist/{src/simple → simple}/with-audio-file.d.ts +0 -0
  594. /package/dist/{src/taglib → taglib}/audio-file-base.d.ts +0 -0
  595. /package/dist/{src/taglib → taglib}/audio-file-bwf.d.ts +0 -0
  596. /package/dist/{src/taglib → taglib}/audio-file-checksum.d.ts +0 -0
  597. /package/dist/{src/taglib → taglib}/audio-file-impl.d.ts +0 -0
  598. /package/dist/{src/taglib → taglib}/audio-file-interface.d.ts +0 -0
  599. /package/dist/{src/taglib → taglib}/auto-dispose.d.ts +0 -0
  600. /package/dist/{src/taglib → taglib}/embind-adapter.d.ts +0 -0
  601. /package/dist/{src/taglib → taglib}/extra-state-registry.d.ts +0 -0
  602. /package/dist/{src/taglib → taglib}/index.d.ts +0 -0
  603. /package/dist/{src/taglib → taglib}/load-audio-data.d.ts +0 -0
  604. /package/dist/{src/taglib → taglib}/media-ranges.d.ts +0 -0
  605. /package/dist/{src/taglib → taglib}/metadata-extent.d.ts +0 -0
  606. /package/dist/{src/taglib → taglib}/mp4-item-names.d.ts +0 -0
  607. /package/dist/{src/taglib → taglib}/mutable-tag-impl.d.ts +0 -0
  608. /package/dist/{src/taglib → taglib}/mutable-tag.d.ts +0 -0
  609. /package/dist/{src/taglib → taglib}/save-reconstruct.d.ts +0 -0
  610. /package/dist/{src/taglib → taglib}/taglib-class.d.ts +0 -0
  611. /package/dist/{src/taglib.d.ts → taglib.d.ts} +0 -0
  612. /package/dist/{src/types → types}/audio-formats.d.ts +0 -0
  613. /package/dist/{src/types → types}/bwf.d.ts +0 -0
  614. /package/dist/{src/types → types}/chapters.d.ts +0 -0
  615. /package/dist/{src/types → types}/config.d.ts +0 -0
  616. /package/dist/{src/types → types}/format-property-keys.d.ts +0 -0
  617. /package/dist/{src/types → types}/index.d.ts +0 -0
  618. /package/dist/{src/types → types}/metadata-mappings.d.ts +0 -0
  619. /package/dist/{src/types → types}/pictures.d.ts +0 -0
  620. /package/dist/{src/types → types}/tags.d.ts +0 -0
  621. /package/dist/{src/types.d.ts → types.d.ts} +0 -0
  622. /package/dist/{src/utils → utils}/file.d.ts +0 -0
  623. /package/dist/{src/utils → utils}/mirror-fields.d.ts +0 -0
  624. /package/dist/{src/utils → utils}/node-fs.d.ts +0 -0
  625. /package/dist/{src/utils → utils}/path.d.ts +0 -0
  626. /package/dist/{src/utils → utils}/rating.d.ts +0 -0
  627. /package/dist/{src/utils → utils}/tag-mapping.d.ts +0 -0
  628. /package/dist/{src/utils → utils}/write.d.ts +0 -0
  629. /package/dist/{src/wasm.d.ts → wasm.d.ts} +0 -0
  630. /package/dist/{src/web-utils → web-utils}/canvas.d.ts +0 -0
  631. /package/dist/{src/web-utils → web-utils}/data-url.d.ts +0 -0
  632. /package/dist/{src/web-utils → web-utils}/dom-integration.d.ts +0 -0
  633. /package/dist/{src/web-utils → web-utils}/index.d.ts +0 -0
@@ -0,0 +1,211 @@
1
+ import { toTagLibKey } from "../constants/properties.js";
2
+ import { MetadataError, errorMessage } from "../errors/classes.js";
3
+ import { isShadowedNumericMirror } from "../utils/mirror-fields.js";
4
+ import { encode } from "@msgpack/msgpack";
5
+ //#region src/msgpack/encoder.ts
6
+ /** MessagePack encoder — converts JS objects to binary MessagePack for the C API. */
7
+ /**
8
+ * Structured (non-text-property) keys carried verbatim through the msgpack
9
+ * boundary. The reconstruct registry (`extra-state-registry.ts`) must cover the
10
+ * data fields here; `extra-state-registry.test.ts` enforces that cross-check.
11
+ */
12
+ const PASSTHROUGH_KEYS = /* @__PURE__ */ new Set([
13
+ "pictures",
14
+ "ratings",
15
+ "id3v2Frames",
16
+ "lyrics",
17
+ "chapters",
18
+ "_mp4ChapterStyle",
19
+ "bextData",
20
+ "ixml",
21
+ "id3Tags",
22
+ "_stripId3",
23
+ "_mp4ItemNames",
24
+ "_mp4ItemRemovals"
25
+ ]);
26
+ const MSGPACK_ENCODE_OPTIONS = {
27
+ sortKeys: false,
28
+ forceFloat32: false,
29
+ ignoreUndefined: true,
30
+ initialBufferSize: 2048,
31
+ maxDepth: 32
32
+ };
33
+ /**
34
+ * Flatten the in-memory lyrics value to the plain text strings the "LYRICS"
35
+ * PropertyMap key accepts. Tolerates the three shapes `tagData.lyrics` can hold:
36
+ * a `RawLyrics[]` (from `setLyrics`), a `string[]` (from `setProperties`), or a
37
+ * bare `string` (from a fresh read of the "LYRICS" property).
38
+ */
39
+ function lyricsTexts(value) {
40
+ return (Array.isArray(value) ? value : [value]).map((entry) => {
41
+ if (typeof entry === "string") return entry;
42
+ const text = entry?.text;
43
+ return typeof text === "string" ? text : "";
44
+ }).filter((text) => text !== "");
45
+ }
46
+ function encodeTagData(tagData) {
47
+ try {
48
+ const data = tagData;
49
+ const remapped = {};
50
+ for (const [key, value] of Object.entries(tagData)) {
51
+ if (isShadowedNumericMirror(data, key)) continue;
52
+ if (key === "lyrics") {
53
+ const texts = lyricsTexts(value);
54
+ if (texts.length > 0) remapped["LYRICS"] = texts;
55
+ continue;
56
+ }
57
+ if (PASSTHROUGH_KEYS.has(key)) remapped[key] = value;
58
+ else remapped[toTagLibKey(key)] = value;
59
+ }
60
+ return encode(cleanObject(remapped), MSGPACK_ENCODE_OPTIONS);
61
+ } catch (error) {
62
+ throw new MetadataError("write", `Failed to encode tag data: ${errorMessage(error)}`);
63
+ }
64
+ }
65
+ function encodeAudioProperties(audioProps) {
66
+ try {
67
+ return encode(cleanObject(audioProps), MSGPACK_ENCODE_OPTIONS);
68
+ } catch (error) {
69
+ throw new MetadataError("write", `Failed to encode audio properties: ${errorMessage(error)}`);
70
+ }
71
+ }
72
+ function encodePropertyMap(propertyMap) {
73
+ try {
74
+ return encode(propertyMap, MSGPACK_ENCODE_OPTIONS);
75
+ } catch (error) {
76
+ throw new MetadataError("write", `Failed to encode property map: ${errorMessage(error)}`);
77
+ }
78
+ }
79
+ function encodePicture(picture) {
80
+ try {
81
+ const cleanedPicture = {
82
+ ...picture,
83
+ data: picture.data instanceof Uint8Array ? picture.data : new Uint8Array(picture.data)
84
+ };
85
+ return encode(cleanedPicture, MSGPACK_ENCODE_OPTIONS);
86
+ } catch (error) {
87
+ throw new MetadataError("write", `Failed to encode picture: ${errorMessage(error)}`);
88
+ }
89
+ }
90
+ function encodePictureArray(pictures) {
91
+ try {
92
+ const cleanedPictures = pictures.map((picture) => ({
93
+ ...picture,
94
+ data: picture.data instanceof Uint8Array ? picture.data : new Uint8Array(picture.data)
95
+ }));
96
+ return encode(cleanedPictures, MSGPACK_ENCODE_OPTIONS);
97
+ } catch (error) {
98
+ throw new MetadataError("write", `Failed to encode picture array: ${errorMessage(error)}`);
99
+ }
100
+ }
101
+ function encodeMessagePack(data, options = {}) {
102
+ try {
103
+ const mergedOptions = {
104
+ ...MSGPACK_ENCODE_OPTIONS,
105
+ ...options
106
+ };
107
+ return encode(cleanObject(data), mergedOptions);
108
+ } catch (error) {
109
+ throw new MetadataError("write", `Failed to encode data: ${errorMessage(error)}`);
110
+ }
111
+ }
112
+ function encodeMessagePackCompact(data) {
113
+ try {
114
+ const compactOptions = {
115
+ ...MSGPACK_ENCODE_OPTIONS,
116
+ sortKeys: true,
117
+ initialBufferSize: 512,
118
+ forceFloat32: true
119
+ };
120
+ return encode(cleanObject(data), compactOptions);
121
+ } catch (error) {
122
+ throw new MetadataError("write", `Failed to encode compact data: ${errorMessage(error)}`);
123
+ }
124
+ }
125
+ function cleanObject(obj) {
126
+ if (obj === null || obj === void 0) return null;
127
+ if (typeof obj !== "object") return obj;
128
+ if (obj instanceof Uint8Array || Array.isArray(obj)) return obj;
129
+ if (obj instanceof Date) return obj;
130
+ const cleaned = {};
131
+ for (const [key, value] of Object.entries(obj)) {
132
+ if (value === void 0) continue;
133
+ if (value === null) {
134
+ cleaned[key] = null;
135
+ continue;
136
+ }
137
+ if (typeof value === "string" && value === "") continue;
138
+ cleaned[key] = typeof value === "object" ? cleanObject(value) : value;
139
+ }
140
+ return cleaned;
141
+ }
142
+ function encodeBatchTagData(tagDataArray) {
143
+ try {
144
+ const cleanedArray = tagDataArray.map((tagData) => cleanObject(tagData));
145
+ return encode(cleanedArray, {
146
+ ...MSGPACK_ENCODE_OPTIONS,
147
+ initialBufferSize: 8192,
148
+ maxDepth: 16
149
+ });
150
+ } catch (error) {
151
+ throw new MetadataError("write", `Failed to encode batch tag data: ${errorMessage(error)}`);
152
+ }
153
+ }
154
+ function* encodeMessagePackStream(dataIterator) {
155
+ try {
156
+ for (const item of dataIterator) yield encode(cleanObject(item), {
157
+ ...MSGPACK_ENCODE_OPTIONS,
158
+ initialBufferSize: 1024
159
+ });
160
+ } catch (error) {
161
+ throw new MetadataError("write", `Failed to encode streaming data: ${errorMessage(error)}`);
162
+ }
163
+ }
164
+ function estimateMessagePackSize(data) {
165
+ try {
166
+ return encode(cleanObject(data), {
167
+ ...MSGPACK_ENCODE_OPTIONS,
168
+ initialBufferSize: 512
169
+ }).length;
170
+ } catch {
171
+ return Math.floor(JSON.stringify(data).length * .75);
172
+ }
173
+ }
174
+ function encodeFastTagData(tagData) {
175
+ try {
176
+ return encode(cleanObject(tagData), {
177
+ sortKeys: false,
178
+ ignoreUndefined: true,
179
+ initialBufferSize: 256,
180
+ maxDepth: 8
181
+ });
182
+ } catch (error) {
183
+ throw new MetadataError("write", `Failed to encode fast tag data: ${errorMessage(error)}`);
184
+ }
185
+ }
186
+ function canEncodeToMessagePack(data) {
187
+ try {
188
+ encode(cleanObject(data), {
189
+ ...MSGPACK_ENCODE_OPTIONS,
190
+ maxDepth: 16,
191
+ initialBufferSize: 256
192
+ });
193
+ return true;
194
+ } catch {
195
+ return false;
196
+ }
197
+ }
198
+ function compareEncodingEfficiency(data) {
199
+ const jsonString = JSON.stringify(data);
200
+ const jsonSize = new TextEncoder().encode(jsonString).length;
201
+ const messagePackSize = encode(cleanObject(data), MSGPACK_ENCODE_OPTIONS).length;
202
+ const sizeReduction = (jsonSize - messagePackSize) / jsonSize * 100;
203
+ return {
204
+ messagePackSize,
205
+ jsonSize,
206
+ sizeReduction: Math.max(0, sizeReduction),
207
+ speedImprovement: 10
208
+ };
209
+ }
210
+ //#endregion
211
+ export { PASSTHROUGH_KEYS, canEncodeToMessagePack, compareEncodingEfficiency, encodeAudioProperties, encodeBatchTagData, encodeFastTagData, encodeMessagePack, encodeMessagePackCompact, encodeMessagePackStream, encodePicture, encodePictureArray, encodePropertyMap, encodeTagData, estimateMessagePackSize };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/msgpack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { decodeAudioProperties, decodeFastTagData, decodeMessagePack, decodeMessagePackAuto, decodePicture, decodePictureArray, decodePropertyMap, decodeTagData, getMessagePackInfo, isValidMessagePack } from "./decoder.js";
2
+ import { canEncodeToMessagePack, compareEncodingEfficiency, encodeAudioProperties, encodeBatchTagData, encodeFastTagData, encodeMessagePack, encodeMessagePackCompact, encodeMessagePackStream, encodePicture, encodePictureArray, encodePropertyMap, encodeTagData, estimateMessagePackSize } from "./encoder.js";
3
+ import { TAGLIB_MSGPACK_MARKERS } from "./types.js";
4
+ import { MessagePackUtils } from "./utils.js";
5
+ export { MessagePackUtils, TAGLIB_MSGPACK_MARKERS, canEncodeToMessagePack, compareEncodingEfficiency, decodeAudioProperties, decodeFastTagData, decodeMessagePack, decodeMessagePackAuto, decodePicture, decodePictureArray, decodePropertyMap, decodeTagData, encodeAudioProperties, encodeBatchTagData, encodeFastTagData, encodeMessagePack, encodeMessagePackCompact, encodeMessagePackStream, encodePicture, encodePictureArray, encodePropertyMap, encodeTagData, estimateMessagePackSize, getMessagePackInfo, isValidMessagePack };
@@ -62,7 +62,7 @@ export declare const TAGLIB_MSGPACK_MARKERS: {
62
62
  readonly STREAM_CHUNK: 6;
63
63
  readonly ERROR_RESPONSE: 255;
64
64
  };
65
- export type TagLibMessagePackMarker = typeof TAGLIB_MSGPACK_MARKERS[keyof typeof TAGLIB_MSGPACK_MARKERS];
65
+ export type TagLibMessagePackMarker = (typeof TAGLIB_MSGPACK_MARKERS)[keyof typeof TAGLIB_MSGPACK_MARKERS];
66
66
  export interface FormatVersion {
67
67
  major: number;
68
68
  minor: number;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/msgpack/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ //#region src/msgpack/types.ts
2
+ /** TagLib-specific MessagePack format markers */
3
+ const TAGLIB_MSGPACK_MARKERS = {
4
+ TAG_DATA: 1,
5
+ AUDIO_PROPERTIES: 2,
6
+ PICTURE_DATA: 3,
7
+ PROPERTY_MAP: 4,
8
+ BATCH_DATA: 5,
9
+ STREAM_CHUNK: 6,
10
+ ERROR_RESPONSE: 255
11
+ };
12
+ //#endregion
13
+ export { TAGLIB_MSGPACK_MARKERS };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/msgpack/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAYrB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,MAAM,EAAE,UAAU,GACjB,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW;IAIxD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI;IAW/D;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,IAAI;IAW5E;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI;IAW5D;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG;QAClD,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,yBAAyB,EAAE,MAAM,CAAC;KACnC;IAUD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAYzC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;IAY/C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;QAC/C,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,GAAG,OAAO,GAAG,WAAW,CAAC;QAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAcF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAqBlD"}
@@ -0,0 +1,116 @@
1
+ import { MetadataError, errorMessage } from "../errors/classes.js";
2
+ import { decodeAudioProperties, decodeMessagePackAuto, decodePicture, decodeTagData, isValidMessagePack } from "./decoder.js";
3
+ import { compareEncodingEfficiency, encodeTagData } from "./encoder.js";
4
+ //#region src/msgpack/utils.ts
5
+ /**
6
+ * @fileoverview High-level MessagePack utilities for common TagLib-Wasm operations
7
+ */
8
+ /**
9
+ * High-level MessagePack utilities for common TagLib-Wasm operations
10
+ */
11
+ var MessagePackUtils = class {
12
+ /**
13
+ * Smart decode that automatically detects the data type
14
+ */
15
+ static decode(buffer) {
16
+ return decodeMessagePackAuto(buffer);
17
+ }
18
+ /**
19
+ * Validate and decode tag data with error handling
20
+ */
21
+ static safeDecodeTagData(buffer) {
22
+ try {
23
+ if (!isValidMessagePack(buffer)) return null;
24
+ return decodeTagData(buffer);
25
+ } catch {
26
+ return null;
27
+ }
28
+ }
29
+ /**
30
+ * Validate and decode audio properties with error handling
31
+ */
32
+ static safeDecodeAudioProperties(buffer) {
33
+ try {
34
+ if (!isValidMessagePack(buffer)) return null;
35
+ return decodeAudioProperties(buffer);
36
+ } catch {
37
+ return null;
38
+ }
39
+ }
40
+ /**
41
+ * Validate and decode picture data with error handling
42
+ */
43
+ static safeDecodePicture(buffer) {
44
+ try {
45
+ if (!isValidMessagePack(buffer)) return null;
46
+ return decodePicture(buffer);
47
+ } catch {
48
+ return null;
49
+ }
50
+ }
51
+ /**
52
+ * Get performance metrics for MessagePack vs JSON
53
+ */
54
+ static getPerformanceComparison(data) {
55
+ const comparison = compareEncodingEfficiency(data);
56
+ return {
57
+ messagePackSize: comparison.messagePackSize,
58
+ jsonSize: comparison.jsonSize,
59
+ sizeReduction: comparison.sizeReduction,
60
+ estimatedSpeedImprovement: comparison.speedImprovement
61
+ };
62
+ }
63
+ /**
64
+ * Convert between MessagePack and JSON for debugging/comparison
65
+ */
66
+ static toJson(buffer) {
67
+ try {
68
+ const decoded = decodeMessagePackAuto(buffer);
69
+ return JSON.stringify(decoded, null, 2);
70
+ } catch (error) {
71
+ throw new MetadataError("read", `Failed to convert to JSON: ${errorMessage(error)}`);
72
+ }
73
+ }
74
+ /**
75
+ * Convert JSON back to MessagePack (for testing/migration)
76
+ */
77
+ static fromJson(jsonString) {
78
+ try {
79
+ const data = JSON.parse(jsonString);
80
+ return encodeTagData(data);
81
+ } catch (error) {
82
+ throw new MetadataError("write", `Failed to convert from JSON: ${errorMessage(error)}`);
83
+ }
84
+ }
85
+ /**
86
+ * Batch process multiple MessagePack buffers
87
+ */
88
+ static batchDecode(buffers) {
89
+ return buffers.map((buffer) => {
90
+ try {
91
+ return {
92
+ success: true,
93
+ data: decodeMessagePackAuto(buffer)
94
+ };
95
+ } catch (error) {
96
+ return {
97
+ success: false,
98
+ error: error instanceof Error ? error.message : "Unknown error"
99
+ };
100
+ }
101
+ });
102
+ }
103
+ /**
104
+ * Check if data is compatible with TagLib MessagePack format
105
+ */
106
+ static isTagLibCompatible(data) {
107
+ if (typeof data !== "object" || data === null) return false;
108
+ const obj = data;
109
+ if ("title" in obj || "artist" in obj || "album" in obj) return true;
110
+ if ("bitrate" in obj && "sampleRate" in obj) return true;
111
+ if ("mimeType" in obj && "data" in obj) return true;
112
+ return false;
113
+ }
114
+ };
115
+ //#endregion
116
+ export { MessagePackUtils };
package/dist/rating.d.ts CHANGED
@@ -11,5 +11,5 @@
11
11
  * const popm = toPopm(0.8); // 196
12
12
  * ```
13
13
  */
14
- export * from "./src/utils/rating.js";
14
+ export * from "./utils/rating.js";
15
15
  //# sourceMappingURL=rating.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../rating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,uBAAuB,CAAC"}
1
+ {"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../src/rating.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,mBAAmB,CAAC"}
package/dist/rating.js CHANGED
@@ -1,2 +1,2 @@
1
- // rating.ts
2
- export * from "./src/utils/rating.js";
1
+ import { RatingUtils, clamp, fromNormalized, fromPercent, fromPopm, fromStars, isValid, normalized, popm, toNormalized, toPercent, toPopm, toStars } from "./utils/rating.js";
2
+ export { RatingUtils, clamp, fromNormalized, fromPercent, fromPopm, fromStars, isValid, normalized, popm, toNormalized, toPercent, toPopm, toStars };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deno-detect.d.ts","sourceRoot":"","sources":["../../src/runtime/deno-detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,cAAc,IAAI,OAAO,CAMxC"}
@@ -0,0 +1,12 @@
1
+ //#region src/runtime/deno-detect.ts
2
+ /**
3
+ * @fileoverview Detect if running inside a Deno compiled binary
4
+ *
5
+ * Shared by module-loader.ts and deno-compile.ts to avoid duplication.
6
+ * Intentionally zero-dependency to prevent circular imports.
7
+ */
8
+ function isDenoCompiled() {
9
+ return typeof Deno !== "undefined" && typeof Deno.mainModule === "string" && Deno.mainModule.includes("deno-compile://");
10
+ }
11
+ //#endregion
12
+ export { isDenoCompiled };
@@ -36,6 +36,8 @@ export declare function detectRuntime(): RuntimeDetectionResult;
36
36
  * Uses `WebAssembly.validate()` with a minimal probe module — synchronous and zero-cost.
37
37
  */
38
38
  export declare function supportsExnref(): boolean;
39
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
39
40
  export declare function getEnvironmentDescription(env: RuntimeEnvironment): string;
41
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
40
42
  export declare function canLoadWasmType(wasmType: WasmBinaryType, env?: RuntimeEnvironment): boolean;
41
43
  //# sourceMappingURL=detector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/runtime/detector.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,WAAW,GACX,UAAU,GACV,SAAS,GACT,iBAAiB,GACjB,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC5B;AA+CD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,kBAAkB,GACtB,kBAAkB,CAEpB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAepB;AA4CD,qFAAqF;AACrF,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED,wBAAgB,aAAa,IAAI,sBAAsB,CAuCtD;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAmBzE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,GAAE,kBAAgD,GACpD,OAAO,CAKT"}
@@ -0,0 +1,173 @@
1
+ //#region src/runtime/detector.ts
2
+ const ENVIRONMENT_PROFILES = {
3
+ "deno-wasi": {
4
+ wasmType: "wasi",
5
+ supportsFilesystem: true,
6
+ supportsStreaming: true,
7
+ performanceTier: 1
8
+ },
9
+ "node-wasi": {
10
+ wasmType: "wasi",
11
+ supportsFilesystem: true,
12
+ supportsStreaming: true,
13
+ performanceTier: 1
14
+ },
15
+ "bun-wasi": {
16
+ wasmType: "wasi",
17
+ supportsFilesystem: true,
18
+ supportsStreaming: true,
19
+ performanceTier: 1
20
+ },
21
+ browser: {
22
+ wasmType: "emscripten",
23
+ supportsFilesystem: false,
24
+ supportsStreaming: true,
25
+ performanceTier: 2
26
+ },
27
+ worker: {
28
+ wasmType: "emscripten",
29
+ supportsFilesystem: false,
30
+ supportsStreaming: true,
31
+ performanceTier: 2
32
+ },
33
+ cloudflare: {
34
+ wasmType: "emscripten",
35
+ supportsFilesystem: false,
36
+ supportsStreaming: false,
37
+ performanceTier: 3
38
+ },
39
+ "node-emscripten": {
40
+ wasmType: "emscripten",
41
+ supportsFilesystem: true,
42
+ supportsStreaming: true,
43
+ performanceTier: 3
44
+ }
45
+ };
46
+ /** Pure environment -> backend configuration lookup (taglib-2b4). */
47
+ function environmentProfile(env) {
48
+ return ENVIRONMENT_PROFILES[env];
49
+ }
50
+ const g = globalThis;
51
+ const MIN_NODE_MAJOR = 22;
52
+ const MIN_NODE_MINOR = 6;
53
+ /**
54
+ * Check if a Node.js version meets the minimum requirement (v22.6.0+).
55
+ * Returns an error message string if the version is too old, or undefined if OK.
56
+ * Pass undefined for non-Node environments (always returns undefined).
57
+ */
58
+ function checkNodeVersion(nodeVersion) {
59
+ if (!nodeVersion) return void 0;
60
+ const [major, minor] = nodeVersion.split(".").map(Number);
61
+ if (major < MIN_NODE_MAJOR || major === MIN_NODE_MAJOR && minor < MIN_NODE_MINOR) return `Node.js v${MIN_NODE_MAJOR}.${MIN_NODE_MINOR}.0 or higher is required. Current version: v${nodeVersion}. Older versions lack WASI and Wasm exception handling support.`;
62
+ }
63
+ function hasWASISupport() {
64
+ if (g.Deno !== void 0) return true;
65
+ if (g.process !== void 0 && g.process.versions?.node) {
66
+ const [major] = g.process.versions.node.split(".").map(Number);
67
+ return major >= 16;
68
+ }
69
+ return false;
70
+ }
71
+ function isBrowser() {
72
+ return g.window !== void 0 && g.document !== void 0;
73
+ }
74
+ function isWebWorker() {
75
+ return g.WorkerGlobalScope !== void 0 && g.self !== void 0 && g.self instanceof g.WorkerGlobalScope;
76
+ }
77
+ function isCloudflareWorker() {
78
+ return g.caches !== void 0 && g.Request !== void 0 && typeof g.addEventListener === "function" && g.Deno === void 0 && g.process === void 0;
79
+ }
80
+ function isBun() {
81
+ return g.Bun !== void 0;
82
+ }
83
+ function isNode() {
84
+ return g.process !== void 0 && g.process.versions?.node !== void 0;
85
+ }
86
+ /** Shared Deno-runtime check — do not hand-roll `typeof Deno` tests (taglib-rfr). */
87
+ function isDeno() {
88
+ return g.Deno !== void 0;
89
+ }
90
+ function detectRuntime() {
91
+ if (isDeno() && hasWASISupport()) return {
92
+ environment: "deno-wasi",
93
+ ...environmentProfile("deno-wasi")
94
+ };
95
+ if (isBun()) return {
96
+ environment: "bun-wasi",
97
+ ...environmentProfile("bun-wasi")
98
+ };
99
+ if (isNode() && hasWASISupport()) return {
100
+ environment: "node-wasi",
101
+ ...environmentProfile("node-wasi")
102
+ };
103
+ if (isBrowser()) return {
104
+ environment: "browser",
105
+ ...environmentProfile("browser")
106
+ };
107
+ if (isWebWorker()) return {
108
+ environment: "worker",
109
+ ...environmentProfile("worker")
110
+ };
111
+ if (isCloudflareWorker()) return {
112
+ environment: "cloudflare",
113
+ ...environmentProfile("cloudflare")
114
+ };
115
+ if (isNode()) return {
116
+ environment: "node-emscripten",
117
+ ...environmentProfile("node-emscripten")
118
+ };
119
+ return {
120
+ environment: "browser",
121
+ ...environmentProfile("browser"),
122
+ performanceTier: 3
123
+ };
124
+ }
125
+ const EXNREF_PROBE = new Uint8Array([
126
+ 0,
127
+ 97,
128
+ 115,
129
+ 109,
130
+ 1,
131
+ 0,
132
+ 0,
133
+ 0,
134
+ 6,
135
+ 6,
136
+ 1,
137
+ 105,
138
+ 0,
139
+ 208,
140
+ 105,
141
+ 11
142
+ ]);
143
+ /**
144
+ * Detect whether the runtime supports the Wasm `exnref` type.
145
+ * Uses `WebAssembly.validate()` with a minimal probe module — synchronous and zero-cost.
146
+ */
147
+ function supportsExnref() {
148
+ try {
149
+ return WebAssembly.validate(EXNREF_PROBE);
150
+ } catch {
151
+ return false;
152
+ }
153
+ }
154
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
155
+ function getEnvironmentDescription(env) {
156
+ switch (env) {
157
+ case "deno-wasi": return "Deno with WASI (optimal filesystem performance)";
158
+ case "node-wasi": return "Node.js with WASI (high performance)";
159
+ case "bun-wasi": return "Bun with WASI (Bun-native file I/O)";
160
+ case "browser": return "Browser with Emscripten (web compatibility)";
161
+ case "worker": return "Web Worker with Emscripten";
162
+ case "cloudflare": return "Cloudflare Workers (limited streaming)";
163
+ case "node-emscripten": return "Node.js with Emscripten (fallback mode)";
164
+ default: return "Unknown environment";
165
+ }
166
+ }
167
+ /** @internal Exported for unit tests (tests/runtime-detector-unit.test.ts). */
168
+ function canLoadWasmType(wasmType, env = detectRuntime().environment) {
169
+ if (wasmType === "wasi") return environmentProfile(env).wasmType === "wasi";
170
+ return true;
171
+ }
172
+ //#endregion
173
+ export { canLoadWasmType, checkNodeVersion, detectRuntime, environmentProfile, getEnvironmentDescription, isDeno, supportsExnref };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loader-types.d.ts","sourceRoot":"","sources":["../../src/runtime/loader-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAEtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEtC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,GAAG,UAAU,GAC/B,MAAM,GAAG,IAAI,CAWf"}
@@ -0,0 +1,23 @@
1
+ //#region src/runtime/loader-types.ts
2
+ /**
3
+ * Describe why `wasmBinary` is not a WebAssembly module, or `null` if it is.
4
+ *
5
+ * Both loader entry points validate this before handing the buffer to
6
+ * Emscripten. Left to the glue, a bad buffer surfaces as an asynchronous
7
+ * `Aborted(CompileError: ...)` written straight to the console AFTER the
8
+ * returned promise settles — so a caller can neither attach it to their own
9
+ * failure nor suppress it. The two entry points raise different error types,
10
+ * hence a shared predicate rather than a shared throw.
11
+ */
12
+ function describeNonWasmBinary(binary) {
13
+ const bytes = binary instanceof Uint8Array ? binary : new Uint8Array(binary);
14
+ if (bytes.length >= 4 && [
15
+ 0,
16
+ 97,
17
+ 115,
18
+ 109
19
+ ].every((b, i) => bytes[i] === b)) return null;
20
+ return `wasmBinary is not a WebAssembly module: expected magic bytes 00 61 73 6d, found ${Array.from(bytes.slice(0, 4)).map((b) => b.toString(16).padStart(2, "0")).join(" ") || "(empty)"}. Size: ${bytes.length} bytes`;
21
+ }
22
+ //#endregion
23
+ export { describeNonWasmBinary };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"module-loader-browser.d.ts","sourceRoot":"","sources":["../../src/runtime/module-loader-browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAsDvB"}
@@ -0,0 +1,33 @@
1
+ import { TagLibInitializationError } from "../errors/classes.js";
2
+ //#region src/runtime/module-loader-browser.ts
3
+ /**
4
+ * Load the TagLib Wasm module using Emscripten only.
5
+ *
6
+ * Import paths use `./` because the browser bundle is output to `dist/`
7
+ * alongside `taglib-wrapper.js` and `taglib-web.wasm` (copied by postbuild).
8
+ */
9
+ async function loadTagLibModule(options) {
10
+ let createTagLibModule;
11
+ try {
12
+ createTagLibModule = (await import("../taglib-wrapper.js")).default;
13
+ } catch {
14
+ try {
15
+ createTagLibModule = (await import("../taglib-wrapper.js")).default;
16
+ } catch {
17
+ throw new TagLibInitializationError("Could not load taglib-wrapper.js. Ensure it is co-located with the browser bundle.");
18
+ }
19
+ }
20
+ const moduleConfig = {};
21
+ if (options?.wasmBinary) moduleConfig.wasmBinary = options.wasmBinary;
22
+ if (options?.wasmUrl) moduleConfig.locateFile = (path) => {
23
+ if (path.endsWith(".wasm")) return options.wasmUrl;
24
+ return path;
25
+ };
26
+ else if (!options?.wasmBinary) {
27
+ const wasmUrl = new URL("./taglib-web.wasm", import.meta.url);
28
+ moduleConfig.locateFile = (path) => path.endsWith(".wasm") ? wasmUrl.href : path;
29
+ }
30
+ return await createTagLibModule(moduleConfig);
31
+ }
32
+ //#endregion
33
+ export { loadTagLibModule };
@@ -0,0 +1 @@
1
+ {"version":3,"file":"module-loader.d.ts","sourceRoot":"","sources":["../../src/runtime/module-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAiFvB"}