@ansango/lastfm-api 3.3.0 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (504) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +189 -3
  3. package/dist/client.d.ts +9 -1
  4. package/dist/client.d.ts.map +1 -1
  5. package/dist/client.js +13 -1
  6. package/dist/client.js.map +1 -1
  7. package/dist/core/canonical-methods.d.ts +25 -0
  8. package/dist/core/canonical-methods.d.ts.map +1 -0
  9. package/dist/core/canonical-methods.js +88 -0
  10. package/dist/core/canonical-methods.js.map +1 -0
  11. package/dist/core/client.d.ts +33 -0
  12. package/dist/core/client.d.ts.map +1 -0
  13. package/dist/core/client.js +48 -0
  14. package/dist/core/client.js.map +1 -0
  15. package/dist/core/index.d.ts +6 -0
  16. package/dist/core/index.d.ts.map +1 -0
  17. package/dist/core/index.js +6 -0
  18. package/dist/core/index.js.map +1 -0
  19. package/dist/core/pagination.d.ts +59 -0
  20. package/dist/core/pagination.d.ts.map +1 -0
  21. package/dist/core/pagination.js +93 -0
  22. package/dist/core/pagination.js.map +1 -0
  23. package/dist/core/schemas/album.schemas.d.ts.map +1 -0
  24. package/dist/{services → core/schemas}/album.schemas.js +1 -1
  25. package/dist/core/schemas/album.schemas.js.map +1 -0
  26. package/dist/core/schemas/artist.schemas.d.ts.map +1 -0
  27. package/dist/{services → core/schemas}/artist.schemas.js +1 -1
  28. package/dist/core/schemas/artist.schemas.js.map +1 -0
  29. package/dist/core/schemas/auth.schemas.d.ts.map +1 -0
  30. package/dist/core/schemas/auth.schemas.js.map +1 -0
  31. package/dist/core/schemas/base/base.entities.schemas.d.ts.map +1 -0
  32. package/dist/core/schemas/base/base.entities.schemas.js.map +1 -0
  33. package/dist/core/schemas/base/base.entity-names.schemas.d.ts.map +1 -0
  34. package/dist/core/schemas/base/base.entity-names.schemas.js.map +1 -0
  35. package/dist/core/schemas/base/base.metadata.schemas.d.ts.map +1 -0
  36. package/dist/core/schemas/base/base.metadata.schemas.js.map +1 -0
  37. package/dist/core/schemas/base/base.pagination.schemas.d.ts.map +1 -0
  38. package/dist/core/schemas/base/base.pagination.schemas.js.map +1 -0
  39. package/dist/core/schemas/base/base.primitives.schemas.d.ts.map +1 -0
  40. package/dist/core/schemas/base/base.primitives.schemas.js.map +1 -0
  41. package/dist/core/schemas/base/index.d.ts.map +1 -0
  42. package/dist/core/schemas/base/index.js.map +1 -0
  43. package/dist/core/schemas/chart.schemas.d.ts.map +1 -0
  44. package/dist/{services → core/schemas}/chart.schemas.js +1 -1
  45. package/dist/core/schemas/chart.schemas.js.map +1 -0
  46. package/dist/core/schemas/geo.schemas.d.ts.map +1 -0
  47. package/dist/{services → core/schemas}/geo.schemas.js +1 -1
  48. package/dist/core/schemas/geo.schemas.js.map +1 -0
  49. package/dist/{services → core/schemas}/index.d.ts +1 -10
  50. package/dist/core/schemas/index.d.ts.map +1 -0
  51. package/dist/core/schemas/index.js +11 -0
  52. package/dist/core/schemas/index.js.map +1 -0
  53. package/dist/core/schemas/library.schemas.d.ts.map +1 -0
  54. package/dist/{services → core/schemas}/library.schemas.js +1 -1
  55. package/dist/core/schemas/library.schemas.js.map +1 -0
  56. package/dist/core/schemas/tag.schemas.d.ts.map +1 -0
  57. package/dist/{services → core/schemas}/tag.schemas.js +1 -1
  58. package/dist/core/schemas/tag.schemas.js.map +1 -0
  59. package/dist/core/schemas/track.schemas.d.ts.map +1 -0
  60. package/dist/{services → core/schemas}/track.schemas.js +1 -1
  61. package/dist/core/schemas/track.schemas.js.map +1 -0
  62. package/dist/core/schemas/user.schemas.d.ts.map +1 -0
  63. package/dist/{services → core/schemas}/user.schemas.js +1 -1
  64. package/dist/core/schemas/user.schemas.js.map +1 -0
  65. package/dist/{services → core/services}/album.d.ts +2 -2
  66. package/dist/core/services/album.d.ts.map +1 -0
  67. package/dist/{services → core/services}/album.js +1 -1
  68. package/dist/core/services/album.js.map +1 -0
  69. package/dist/{services → core/services}/artist.d.ts +2 -2
  70. package/dist/core/services/artist.d.ts.map +1 -0
  71. package/dist/{services → core/services}/artist.js +1 -1
  72. package/dist/core/services/artist.js.map +1 -0
  73. package/dist/{services → core/services}/auth.d.ts +2 -2
  74. package/dist/core/services/auth.d.ts.map +1 -0
  75. package/dist/{services → core/services}/auth.js +1 -1
  76. package/dist/core/services/auth.js.map +1 -0
  77. package/dist/{services → core/services}/chart.d.ts +2 -2
  78. package/dist/core/services/chart.d.ts.map +1 -0
  79. package/dist/{services → core/services}/chart.js +1 -1
  80. package/dist/core/services/chart.js.map +1 -0
  81. package/dist/{services → core/services}/geo.d.ts +2 -2
  82. package/dist/core/services/geo.d.ts.map +1 -0
  83. package/dist/{services → core/services}/geo.js +1 -1
  84. package/dist/core/services/geo.js.map +1 -0
  85. package/dist/core/services/index.d.ts +10 -0
  86. package/dist/core/services/index.d.ts.map +1 -0
  87. package/dist/core/services/index.js +10 -0
  88. package/dist/core/services/index.js.map +1 -0
  89. package/dist/{services → core/services}/library.d.ts +2 -2
  90. package/dist/core/services/library.d.ts.map +1 -0
  91. package/dist/{services → core/services}/library.js +1 -1
  92. package/dist/core/services/library.js.map +1 -0
  93. package/dist/{services → core/services}/tag.d.ts +2 -2
  94. package/dist/core/services/tag.d.ts.map +1 -0
  95. package/dist/{services → core/services}/tag.js +1 -1
  96. package/dist/core/services/tag.js.map +1 -0
  97. package/dist/{services → core/services}/track.d.ts +2 -2
  98. package/dist/core/services/track.d.ts.map +1 -0
  99. package/dist/{services → core/services}/track.js +1 -1
  100. package/dist/core/services/track.js.map +1 -0
  101. package/dist/{services → core/services}/track.utils.d.ts +2 -2
  102. package/dist/core/services/track.utils.d.ts.map +1 -0
  103. package/dist/core/services/track.utils.js.map +1 -0
  104. package/dist/{services → core/services}/user.d.ts +2 -2
  105. package/dist/core/services/user.d.ts.map +1 -0
  106. package/dist/{services → core/services}/user.js +1 -1
  107. package/dist/core/services/user.js.map +1 -0
  108. package/dist/entrypoints/album.d.ts +3 -3
  109. package/dist/entrypoints/album.d.ts.map +1 -1
  110. package/dist/entrypoints/album.js +2 -2
  111. package/dist/entrypoints/album.js.map +1 -1
  112. package/dist/entrypoints/album.schemas.d.ts +2 -1
  113. package/dist/entrypoints/album.schemas.d.ts.map +1 -1
  114. package/dist/entrypoints/album.schemas.js +1 -2
  115. package/dist/entrypoints/album.schemas.js.map +1 -1
  116. package/dist/entrypoints/artist.d.ts +3 -3
  117. package/dist/entrypoints/artist.d.ts.map +1 -1
  118. package/dist/entrypoints/artist.js +2 -2
  119. package/dist/entrypoints/artist.js.map +1 -1
  120. package/dist/entrypoints/artist.schemas.d.ts +2 -1
  121. package/dist/entrypoints/artist.schemas.d.ts.map +1 -1
  122. package/dist/entrypoints/artist.schemas.js +1 -2
  123. package/dist/entrypoints/artist.schemas.js.map +1 -1
  124. package/dist/entrypoints/auth.d.ts +3 -3
  125. package/dist/entrypoints/auth.d.ts.map +1 -1
  126. package/dist/entrypoints/auth.js +2 -2
  127. package/dist/entrypoints/auth.js.map +1 -1
  128. package/dist/entrypoints/auth.schemas.d.ts +2 -1
  129. package/dist/entrypoints/auth.schemas.d.ts.map +1 -1
  130. package/dist/entrypoints/auth.schemas.js +1 -2
  131. package/dist/entrypoints/auth.schemas.js.map +1 -1
  132. package/dist/entrypoints/base.schemas.d.ts +2 -1
  133. package/dist/entrypoints/base.schemas.d.ts.map +1 -1
  134. package/dist/entrypoints/base.schemas.js +1 -2
  135. package/dist/entrypoints/base.schemas.js.map +1 -1
  136. package/dist/entrypoints/chart.d.ts +3 -3
  137. package/dist/entrypoints/chart.d.ts.map +1 -1
  138. package/dist/entrypoints/chart.js +2 -2
  139. package/dist/entrypoints/chart.js.map +1 -1
  140. package/dist/entrypoints/chart.schemas.d.ts +2 -1
  141. package/dist/entrypoints/chart.schemas.d.ts.map +1 -1
  142. package/dist/entrypoints/chart.schemas.js +1 -2
  143. package/dist/entrypoints/chart.schemas.js.map +1 -1
  144. package/dist/entrypoints/core.d.ts +5 -0
  145. package/dist/entrypoints/core.d.ts.map +1 -0
  146. package/dist/entrypoints/core.js +5 -0
  147. package/dist/entrypoints/core.js.map +1 -0
  148. package/dist/entrypoints/core.schemas.d.ts +3 -0
  149. package/dist/entrypoints/core.schemas.d.ts.map +1 -0
  150. package/dist/entrypoints/core.schemas.js +2 -0
  151. package/dist/entrypoints/core.schemas.js.map +1 -0
  152. package/dist/entrypoints/exporter.d.ts +3 -0
  153. package/dist/entrypoints/exporter.d.ts.map +1 -0
  154. package/dist/entrypoints/exporter.js +3 -0
  155. package/dist/entrypoints/exporter.js.map +1 -0
  156. package/dist/entrypoints/exporter.schemas.d.ts +3 -0
  157. package/dist/entrypoints/exporter.schemas.d.ts.map +1 -0
  158. package/dist/entrypoints/exporter.schemas.js +2 -0
  159. package/dist/entrypoints/exporter.schemas.js.map +1 -0
  160. package/dist/entrypoints/geo.d.ts +3 -3
  161. package/dist/entrypoints/geo.d.ts.map +1 -1
  162. package/dist/entrypoints/geo.js +2 -2
  163. package/dist/entrypoints/geo.js.map +1 -1
  164. package/dist/entrypoints/geo.schemas.d.ts +2 -1
  165. package/dist/entrypoints/geo.schemas.d.ts.map +1 -1
  166. package/dist/entrypoints/geo.schemas.js +1 -2
  167. package/dist/entrypoints/geo.schemas.js.map +1 -1
  168. package/dist/entrypoints/insights.d.ts +4 -0
  169. package/dist/entrypoints/insights.d.ts.map +1 -0
  170. package/dist/entrypoints/insights.js +3 -0
  171. package/dist/entrypoints/insights.js.map +1 -0
  172. package/dist/entrypoints/insights.schemas.d.ts +3 -0
  173. package/dist/entrypoints/insights.schemas.d.ts.map +1 -0
  174. package/dist/entrypoints/insights.schemas.js +2 -0
  175. package/dist/entrypoints/insights.schemas.js.map +1 -0
  176. package/dist/entrypoints/library.d.ts +3 -3
  177. package/dist/entrypoints/library.d.ts.map +1 -1
  178. package/dist/entrypoints/library.js +2 -2
  179. package/dist/entrypoints/library.js.map +1 -1
  180. package/dist/entrypoints/library.schemas.d.ts +2 -1
  181. package/dist/entrypoints/library.schemas.d.ts.map +1 -1
  182. package/dist/entrypoints/library.schemas.js +1 -2
  183. package/dist/entrypoints/library.schemas.js.map +1 -1
  184. package/dist/entrypoints/playlists.d.ts +3 -0
  185. package/dist/entrypoints/playlists.d.ts.map +1 -0
  186. package/dist/entrypoints/playlists.js +3 -0
  187. package/dist/entrypoints/playlists.js.map +1 -0
  188. package/dist/entrypoints/playlists.schemas.d.ts +3 -0
  189. package/dist/entrypoints/playlists.schemas.d.ts.map +1 -0
  190. package/dist/entrypoints/playlists.schemas.js +2 -0
  191. package/dist/entrypoints/playlists.schemas.js.map +1 -0
  192. package/dist/entrypoints/reports.d.ts +4 -0
  193. package/dist/entrypoints/reports.d.ts.map +1 -0
  194. package/dist/entrypoints/reports.js +3 -0
  195. package/dist/entrypoints/reports.js.map +1 -0
  196. package/dist/entrypoints/reports.schemas.d.ts +3 -0
  197. package/dist/entrypoints/reports.schemas.d.ts.map +1 -0
  198. package/dist/entrypoints/reports.schemas.js +2 -0
  199. package/dist/entrypoints/reports.schemas.js.map +1 -0
  200. package/dist/entrypoints/tag.d.ts +3 -3
  201. package/dist/entrypoints/tag.d.ts.map +1 -1
  202. package/dist/entrypoints/tag.js +2 -2
  203. package/dist/entrypoints/tag.js.map +1 -1
  204. package/dist/entrypoints/tag.schemas.d.ts +2 -1
  205. package/dist/entrypoints/tag.schemas.d.ts.map +1 -1
  206. package/dist/entrypoints/tag.schemas.js +1 -2
  207. package/dist/entrypoints/tag.schemas.js.map +1 -1
  208. package/dist/entrypoints/track.d.ts +3 -3
  209. package/dist/entrypoints/track.d.ts.map +1 -1
  210. package/dist/entrypoints/track.js +2 -2
  211. package/dist/entrypoints/track.js.map +1 -1
  212. package/dist/entrypoints/track.schemas.d.ts +2 -1
  213. package/dist/entrypoints/track.schemas.d.ts.map +1 -1
  214. package/dist/entrypoints/track.schemas.js +1 -2
  215. package/dist/entrypoints/track.schemas.js.map +1 -1
  216. package/dist/entrypoints/user.d.ts +3 -3
  217. package/dist/entrypoints/user.d.ts.map +1 -1
  218. package/dist/entrypoints/user.js +2 -2
  219. package/dist/entrypoints/user.js.map +1 -1
  220. package/dist/entrypoints/user.schemas.d.ts +2 -1
  221. package/dist/entrypoints/user.schemas.d.ts.map +1 -1
  222. package/dist/entrypoints/user.schemas.js +1 -2
  223. package/dist/entrypoints/user.schemas.js.map +1 -1
  224. package/dist/exporter/engines/library.d.ts +4 -0
  225. package/dist/exporter/engines/library.d.ts.map +1 -0
  226. package/dist/exporter/engines/library.js +34 -0
  227. package/dist/exporter/engines/library.js.map +1 -0
  228. package/dist/exporter/engines/loved.d.ts +4 -0
  229. package/dist/exporter/engines/loved.d.ts.map +1 -0
  230. package/dist/exporter/engines/loved.js +35 -0
  231. package/dist/exporter/engines/loved.js.map +1 -0
  232. package/dist/exporter/engines/scrobbles.d.ts +4 -0
  233. package/dist/exporter/engines/scrobbles.d.ts.map +1 -0
  234. package/dist/exporter/engines/scrobbles.js +74 -0
  235. package/dist/exporter/engines/scrobbles.js.map +1 -0
  236. package/dist/exporter/formats/csv.d.ts +5 -0
  237. package/dist/exporter/formats/csv.d.ts.map +1 -0
  238. package/dist/exporter/formats/csv.js +35 -0
  239. package/dist/exporter/formats/csv.js.map +1 -0
  240. package/dist/exporter/formats/jsonl.d.ts +2 -0
  241. package/dist/exporter/formats/jsonl.d.ts.map +1 -0
  242. package/dist/exporter/formats/jsonl.js +4 -0
  243. package/dist/exporter/formats/jsonl.js.map +1 -0
  244. package/dist/exporter/formats/listenbrainz.d.ts +3 -0
  245. package/dist/exporter/formats/listenbrainz.d.ts.map +1 -0
  246. package/dist/exporter/formats/listenbrainz.js +19 -0
  247. package/dist/exporter/formats/listenbrainz.js.map +1 -0
  248. package/dist/exporter/index.d.ts +6 -0
  249. package/dist/exporter/index.d.ts.map +1 -0
  250. package/dist/exporter/index.js +6 -0
  251. package/dist/exporter/index.js.map +1 -0
  252. package/dist/exporter/schemas.d.ts +291 -0
  253. package/dist/exporter/schemas.d.ts.map +1 -0
  254. package/dist/exporter/schemas.js +81 -0
  255. package/dist/exporter/schemas.js.map +1 -0
  256. package/dist/exporter/service.d.ts +30 -0
  257. package/dist/exporter/service.d.ts.map +1 -0
  258. package/dist/exporter/service.js +11 -0
  259. package/dist/exporter/service.js.map +1 -0
  260. package/dist/index.d.ts +14 -22
  261. package/dist/index.d.ts.map +1 -1
  262. package/dist/index.js +17 -15
  263. package/dist/index.js.map +1 -1
  264. package/dist/insights/algorithms/album-habits.d.ts +7 -0
  265. package/dist/insights/algorithms/album-habits.d.ts.map +1 -0
  266. package/dist/insights/algorithms/album-habits.js +154 -0
  267. package/dist/insights/algorithms/album-habits.js.map +1 -0
  268. package/dist/insights/algorithms/binges.d.ts +8 -0
  269. package/dist/insights/algorithms/binges.d.ts.map +1 -0
  270. package/dist/insights/algorithms/binges.js +53 -0
  271. package/dist/insights/algorithms/binges.js.map +1 -0
  272. package/dist/insights/algorithms/compare.d.ts +8 -0
  273. package/dist/insights/algorithms/compare.d.ts.map +1 -0
  274. package/dist/insights/algorithms/compare.js +39 -0
  275. package/dist/insights/algorithms/compare.js.map +1 -0
  276. package/dist/insights/algorithms/decay.d.ts +11 -0
  277. package/dist/insights/algorithms/decay.d.ts.map +1 -0
  278. package/dist/insights/algorithms/decay.js +154 -0
  279. package/dist/insights/algorithms/decay.js.map +1 -0
  280. package/dist/insights/algorithms/discoveries.d.ts +8 -0
  281. package/dist/insights/algorithms/discoveries.d.ts.map +1 -0
  282. package/dist/insights/algorithms/discoveries.js +53 -0
  283. package/dist/insights/algorithms/discoveries.js.map +1 -0
  284. package/dist/insights/algorithms/genres.d.ts +11 -0
  285. package/dist/insights/algorithms/genres.d.ts.map +1 -0
  286. package/dist/insights/algorithms/genres.js +201 -0
  287. package/dist/insights/algorithms/genres.js.map +1 -0
  288. package/dist/insights/algorithms/group.d.ts +8 -0
  289. package/dist/insights/algorithms/group.d.ts.map +1 -0
  290. package/dist/insights/algorithms/group.js +127 -0
  291. package/dist/insights/algorithms/group.js.map +1 -0
  292. package/dist/insights/algorithms/hours.d.ts +8 -0
  293. package/dist/insights/algorithms/hours.d.ts.map +1 -0
  294. package/dist/insights/algorithms/hours.js +43 -0
  295. package/dist/insights/algorithms/hours.js.map +1 -0
  296. package/dist/insights/algorithms/mood.d.ts +8 -0
  297. package/dist/insights/algorithms/mood.d.ts.map +1 -0
  298. package/dist/insights/algorithms/mood.js +53 -0
  299. package/dist/insights/algorithms/mood.js.map +1 -0
  300. package/dist/insights/algorithms/now-playing.d.ts +20 -0
  301. package/dist/insights/algorithms/now-playing.d.ts.map +1 -0
  302. package/dist/insights/algorithms/now-playing.js +128 -0
  303. package/dist/insights/algorithms/now-playing.js.map +1 -0
  304. package/dist/insights/algorithms/obscurity.d.ts +27 -0
  305. package/dist/insights/algorithms/obscurity.d.ts.map +1 -0
  306. package/dist/insights/algorithms/obscurity.js +158 -0
  307. package/dist/insights/algorithms/obscurity.js.map +1 -0
  308. package/dist/insights/algorithms/personality.d.ts +8 -0
  309. package/dist/insights/algorithms/personality.d.ts.map +1 -0
  310. package/dist/insights/algorithms/personality.js +42 -0
  311. package/dist/insights/algorithms/personality.js.map +1 -0
  312. package/dist/insights/algorithms/recommendations.d.ts +11 -0
  313. package/dist/insights/algorithms/recommendations.d.ts.map +1 -0
  314. package/dist/insights/algorithms/recommendations.js +121 -0
  315. package/dist/insights/algorithms/recommendations.js.map +1 -0
  316. package/dist/insights/algorithms/streaks.d.ts +11 -0
  317. package/dist/insights/algorithms/streaks.d.ts.map +1 -0
  318. package/dist/insights/algorithms/streaks.js +178 -0
  319. package/dist/insights/algorithms/streaks.js.map +1 -0
  320. package/dist/insights/algorithms/summary.d.ts +8 -0
  321. package/dist/insights/algorithms/summary.d.ts.map +1 -0
  322. package/dist/insights/algorithms/summary.js +117 -0
  323. package/dist/insights/algorithms/summary.js.map +1 -0
  324. package/dist/insights/algorithms/trends.d.ts +8 -0
  325. package/dist/insights/algorithms/trends.d.ts.map +1 -0
  326. package/dist/insights/algorithms/trends.js +96 -0
  327. package/dist/insights/algorithms/trends.js.map +1 -0
  328. package/dist/insights/index.d.ts +3 -0
  329. package/dist/insights/index.d.ts.map +1 -0
  330. package/dist/insights/index.js +3 -0
  331. package/dist/insights/index.js.map +1 -0
  332. package/dist/insights/lib/binges.d.ts +31 -0
  333. package/dist/insights/lib/binges.d.ts.map +1 -0
  334. package/dist/insights/lib/binges.js +61 -0
  335. package/dist/insights/lib/binges.js.map +1 -0
  336. package/dist/insights/lib/compare.d.ts +31 -0
  337. package/dist/insights/lib/compare.d.ts.map +1 -0
  338. package/dist/insights/lib/compare.js +68 -0
  339. package/dist/insights/lib/compare.js.map +1 -0
  340. package/dist/insights/lib/discoveries.d.ts +17 -0
  341. package/dist/insights/lib/discoveries.d.ts.map +1 -0
  342. package/dist/insights/lib/discoveries.js +24 -0
  343. package/dist/insights/lib/discoveries.js.map +1 -0
  344. package/dist/insights/lib/diversity.d.ts +28 -0
  345. package/dist/insights/lib/diversity.d.ts.map +1 -0
  346. package/dist/insights/lib/diversity.js +39 -0
  347. package/dist/insights/lib/diversity.js.map +1 -0
  348. package/dist/insights/lib/hours.d.ts +39 -0
  349. package/dist/insights/lib/hours.d.ts.map +1 -0
  350. package/dist/insights/lib/hours.js +66 -0
  351. package/dist/insights/lib/hours.js.map +1 -0
  352. package/dist/insights/lib/mood.d.ts +22 -0
  353. package/dist/insights/lib/mood.d.ts.map +1 -0
  354. package/dist/insights/lib/mood.js +187 -0
  355. package/dist/insights/lib/mood.js.map +1 -0
  356. package/dist/insights/lib/periods.d.ts +17 -0
  357. package/dist/insights/lib/periods.d.ts.map +1 -0
  358. package/dist/insights/lib/periods.js +66 -0
  359. package/dist/insights/lib/periods.js.map +1 -0
  360. package/dist/insights/lib/personality.d.ts +30 -0
  361. package/dist/insights/lib/personality.d.ts.map +1 -0
  362. package/dist/insights/lib/personality.js +131 -0
  363. package/dist/insights/lib/personality.js.map +1 -0
  364. package/dist/insights/lib/trends.d.ts +30 -0
  365. package/dist/insights/lib/trends.d.ts.map +1 -0
  366. package/dist/insights/lib/trends.js +67 -0
  367. package/dist/insights/lib/trends.js.map +1 -0
  368. package/dist/insights/schemas.d.ts +1415 -0
  369. package/dist/insights/schemas.d.ts.map +1 -0
  370. package/dist/insights/schemas.js +596 -0
  371. package/dist/insights/schemas.js.map +1 -0
  372. package/dist/insights/service.d.ts +191 -0
  373. package/dist/insights/service.d.ts.map +1 -0
  374. package/dist/insights/service.js +44 -0
  375. package/dist/insights/service.js.map +1 -0
  376. package/dist/playlists/formatters/csv.d.ts +3 -0
  377. package/dist/playlists/formatters/csv.d.ts.map +1 -0
  378. package/dist/playlists/formatters/csv.js +18 -0
  379. package/dist/playlists/formatters/csv.js.map +1 -0
  380. package/dist/playlists/formatters/m3u.d.ts +3 -0
  381. package/dist/playlists/formatters/m3u.d.ts.map +1 -0
  382. package/dist/playlists/formatters/m3u.js +10 -0
  383. package/dist/playlists/formatters/m3u.js.map +1 -0
  384. package/dist/playlists/formatters/spotifymatch.d.ts +3 -0
  385. package/dist/playlists/formatters/spotifymatch.d.ts.map +1 -0
  386. package/dist/playlists/formatters/spotifymatch.js +4 -0
  387. package/dist/playlists/formatters/spotifymatch.js.map +1 -0
  388. package/dist/playlists/generators/generator.d.ts +4 -0
  389. package/dist/playlists/generators/generator.d.ts.map +1 -0
  390. package/dist/playlists/generators/generator.js +158 -0
  391. package/dist/playlists/generators/generator.js.map +1 -0
  392. package/dist/playlists/index.d.ts +6 -0
  393. package/dist/playlists/index.d.ts.map +1 -0
  394. package/dist/playlists/index.js +6 -0
  395. package/dist/playlists/index.js.map +1 -0
  396. package/dist/playlists/schemas.d.ts +150 -0
  397. package/dist/playlists/schemas.d.ts.map +1 -0
  398. package/dist/playlists/schemas.js +53 -0
  399. package/dist/playlists/schemas.js.map +1 -0
  400. package/dist/playlists/service.d.ts +28 -0
  401. package/dist/playlists/service.d.ts.map +1 -0
  402. package/dist/playlists/service.js +27 -0
  403. package/dist/playlists/service.js.map +1 -0
  404. package/dist/reports/generators/digest.d.ts +4 -0
  405. package/dist/reports/generators/digest.d.ts.map +1 -0
  406. package/dist/reports/generators/digest.js +95 -0
  407. package/dist/reports/generators/digest.js.map +1 -0
  408. package/dist/reports/generators/milestones.d.ts +4 -0
  409. package/dist/reports/generators/milestones.d.ts.map +1 -0
  410. package/dist/reports/generators/milestones.js +59 -0
  411. package/dist/reports/generators/milestones.js.map +1 -0
  412. package/dist/reports/generators/wrapped.d.ts +4 -0
  413. package/dist/reports/generators/wrapped.d.ts.map +1 -0
  414. package/dist/reports/generators/wrapped.js +179 -0
  415. package/dist/reports/generators/wrapped.js.map +1 -0
  416. package/dist/reports/index.d.ts +3 -0
  417. package/dist/reports/index.d.ts.map +1 -0
  418. package/dist/reports/index.js +3 -0
  419. package/dist/reports/index.js.map +1 -0
  420. package/dist/reports/schemas.d.ts +244 -0
  421. package/dist/reports/schemas.d.ts.map +1 -0
  422. package/dist/reports/schemas.js +92 -0
  423. package/dist/reports/schemas.js.map +1 -0
  424. package/dist/reports/service.d.ts +30 -0
  425. package/dist/reports/service.d.ts.map +1 -0
  426. package/dist/reports/service.js +11 -0
  427. package/dist/reports/service.js.map +1 -0
  428. package/package.json +44 -4
  429. package/dist/services/album.d.ts.map +0 -1
  430. package/dist/services/album.js.map +0 -1
  431. package/dist/services/album.schemas.d.ts.map +0 -1
  432. package/dist/services/album.schemas.js.map +0 -1
  433. package/dist/services/artist.d.ts.map +0 -1
  434. package/dist/services/artist.js.map +0 -1
  435. package/dist/services/artist.schemas.d.ts.map +0 -1
  436. package/dist/services/artist.schemas.js.map +0 -1
  437. package/dist/services/auth.d.ts.map +0 -1
  438. package/dist/services/auth.js.map +0 -1
  439. package/dist/services/auth.schemas.d.ts.map +0 -1
  440. package/dist/services/auth.schemas.js.map +0 -1
  441. package/dist/services/chart.d.ts.map +0 -1
  442. package/dist/services/chart.js.map +0 -1
  443. package/dist/services/chart.schemas.d.ts.map +0 -1
  444. package/dist/services/chart.schemas.js.map +0 -1
  445. package/dist/services/geo.d.ts.map +0 -1
  446. package/dist/services/geo.js.map +0 -1
  447. package/dist/services/geo.schemas.d.ts.map +0 -1
  448. package/dist/services/geo.schemas.js.map +0 -1
  449. package/dist/services/index.d.ts.map +0 -1
  450. package/dist/services/index.js +0 -21
  451. package/dist/services/index.js.map +0 -1
  452. package/dist/services/library.d.ts.map +0 -1
  453. package/dist/services/library.js.map +0 -1
  454. package/dist/services/library.schemas.d.ts.map +0 -1
  455. package/dist/services/library.schemas.js.map +0 -1
  456. package/dist/services/schemas/base.entities.schemas.d.ts.map +0 -1
  457. package/dist/services/schemas/base.entities.schemas.js.map +0 -1
  458. package/dist/services/schemas/base.entity-names.schemas.d.ts.map +0 -1
  459. package/dist/services/schemas/base.entity-names.schemas.js.map +0 -1
  460. package/dist/services/schemas/base.metadata.schemas.d.ts.map +0 -1
  461. package/dist/services/schemas/base.metadata.schemas.js.map +0 -1
  462. package/dist/services/schemas/base.pagination.schemas.d.ts.map +0 -1
  463. package/dist/services/schemas/base.pagination.schemas.js.map +0 -1
  464. package/dist/services/schemas/base.primitives.schemas.d.ts.map +0 -1
  465. package/dist/services/schemas/base.primitives.schemas.js.map +0 -1
  466. package/dist/services/schemas/index.d.ts.map +0 -1
  467. package/dist/services/schemas/index.js.map +0 -1
  468. package/dist/services/tag.d.ts.map +0 -1
  469. package/dist/services/tag.js.map +0 -1
  470. package/dist/services/tag.schemas.d.ts.map +0 -1
  471. package/dist/services/tag.schemas.js.map +0 -1
  472. package/dist/services/track.d.ts.map +0 -1
  473. package/dist/services/track.js.map +0 -1
  474. package/dist/services/track.schemas.d.ts.map +0 -1
  475. package/dist/services/track.schemas.js.map +0 -1
  476. package/dist/services/track.utils.d.ts.map +0 -1
  477. package/dist/services/track.utils.js.map +0 -1
  478. package/dist/services/user.d.ts.map +0 -1
  479. package/dist/services/user.js.map +0 -1
  480. package/dist/services/user.schemas.d.ts.map +0 -1
  481. package/dist/services/user.schemas.js.map +0 -1
  482. /package/dist/{services → core/schemas}/album.schemas.d.ts +0 -0
  483. /package/dist/{services → core/schemas}/artist.schemas.d.ts +0 -0
  484. /package/dist/{services → core/schemas}/auth.schemas.d.ts +0 -0
  485. /package/dist/{services → core/schemas}/auth.schemas.js +0 -0
  486. /package/dist/{services/schemas → core/schemas/base}/base.entities.schemas.d.ts +0 -0
  487. /package/dist/{services/schemas → core/schemas/base}/base.entities.schemas.js +0 -0
  488. /package/dist/{services/schemas → core/schemas/base}/base.entity-names.schemas.d.ts +0 -0
  489. /package/dist/{services/schemas → core/schemas/base}/base.entity-names.schemas.js +0 -0
  490. /package/dist/{services/schemas → core/schemas/base}/base.metadata.schemas.d.ts +0 -0
  491. /package/dist/{services/schemas → core/schemas/base}/base.metadata.schemas.js +0 -0
  492. /package/dist/{services/schemas → core/schemas/base}/base.pagination.schemas.d.ts +0 -0
  493. /package/dist/{services/schemas → core/schemas/base}/base.pagination.schemas.js +0 -0
  494. /package/dist/{services/schemas → core/schemas/base}/base.primitives.schemas.d.ts +0 -0
  495. /package/dist/{services/schemas → core/schemas/base}/base.primitives.schemas.js +0 -0
  496. /package/dist/{services/schemas → core/schemas/base}/index.d.ts +0 -0
  497. /package/dist/{services/schemas → core/schemas/base}/index.js +0 -0
  498. /package/dist/{services → core/schemas}/chart.schemas.d.ts +0 -0
  499. /package/dist/{services → core/schemas}/geo.schemas.d.ts +0 -0
  500. /package/dist/{services → core/schemas}/library.schemas.d.ts +0 -0
  501. /package/dist/{services → core/schemas}/tag.schemas.d.ts +0 -0
  502. /package/dist/{services → core/schemas}/track.schemas.d.ts +0 -0
  503. /package/dist/{services → core/schemas}/user.schemas.d.ts +0 -0
  504. /package/dist/{services → core/services}/track.utils.js +0 -0
@@ -0,0 +1,178 @@
1
+ import { createUserService } from '../../core/services/user.js';
2
+ /**
3
+ * Formats a UNIX timestamp (seconds) into UTC YYYY-MM-DD.
4
+ */
5
+ function formatUtcDate(utsSeconds) {
6
+ const d = new Date(utsSeconds * 1000);
7
+ const year = d.getUTCFullYear();
8
+ const month = String(d.getUTCMonth() + 1).padStart(2, '0');
9
+ const day = String(d.getUTCDate()).padStart(2, '0');
10
+ return `${year}-${month}-${day}`;
11
+ }
12
+ /**
13
+ * Calculates listening streaks (current active streak, longest streak, longest dry spell).
14
+ */
15
+ export async function getListeningStreaks(config, params, init) {
16
+ const limit = Math.min(1000, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 500));
17
+ const userService = createUserService(config);
18
+ const recentRes = await userService.getRecentTracks({ user: params.user, limit }, init);
19
+ const rawTracks = recentRes.recenttracks?.track ?? [];
20
+ const tracks = (Array.isArray(rawTracks) ? rawTracks : [rawTracks]).filter((t) => !t['@attr']?.nowplaying);
21
+ if (tracks.length === 0) {
22
+ return {
23
+ user: params.user,
24
+ currentStreakDays: 0,
25
+ longestStreakDays: 0,
26
+ longestDrySpellDays: 0,
27
+ activeDaysCount: 0,
28
+ totalDaysEvaluated: 0,
29
+ averageDailyScrobbles: 0,
30
+ };
31
+ }
32
+ // Group scrobbles per day
33
+ const dailyCounts = {};
34
+ const timestamps = [];
35
+ for (const t of tracks) {
36
+ const uts = Number.parseInt(t.date?.uts ?? '0', 10);
37
+ if (uts > 0) {
38
+ timestamps.push(uts);
39
+ const dateStr = formatUtcDate(uts);
40
+ dailyCounts[dateStr] = (dailyCounts[dateStr] ?? 0) + 1;
41
+ }
42
+ }
43
+ if (timestamps.length === 0) {
44
+ return {
45
+ user: params.user,
46
+ currentStreakDays: 0,
47
+ longestStreakDays: 0,
48
+ longestDrySpellDays: 0,
49
+ activeDaysCount: 0,
50
+ totalDaysEvaluated: 0,
51
+ averageDailyScrobbles: 0,
52
+ };
53
+ }
54
+ timestamps.sort((a, b) => a - b);
55
+ const minDate = new Date(timestamps[0] * 1000);
56
+ const maxDate = new Date(timestamps[timestamps.length - 1] * 1000);
57
+ // Set to start of UTC days
58
+ const cur = new Date(Date.UTC(minDate.getUTCFullYear(), minDate.getUTCMonth(), minDate.getUTCDate()));
59
+ const end = new Date(Date.UTC(maxDate.getUTCFullYear(), maxDate.getUTCMonth(), maxDate.getUTCDate()));
60
+ const fullDaysSeries = [];
61
+ while (cur <= end) {
62
+ const dateStr = cur.toISOString().slice(0, 10);
63
+ const count = dailyCounts[dateStr] ?? 0;
64
+ fullDaysSeries.push({ date: dateStr, active: count > 0, count });
65
+ cur.setUTCDate(cur.getUTCDate() + 1);
66
+ }
67
+ let currentStreak = 0;
68
+ let longestStreak = 0;
69
+ let runningStreak = 0;
70
+ let longestDrySpell = 0;
71
+ let runningDrySpell = 0;
72
+ let activeDaysCount = 0;
73
+ let totalScrobbles = 0;
74
+ for (const day of fullDaysSeries) {
75
+ if (day.active) {
76
+ activeDaysCount += 1;
77
+ totalScrobbles += day.count;
78
+ runningStreak += 1;
79
+ if (runningStreak > longestStreak) {
80
+ longestStreak = runningStreak;
81
+ }
82
+ runningDrySpell = 0;
83
+ }
84
+ else {
85
+ runningStreak = 0;
86
+ runningDrySpell += 1;
87
+ if (runningDrySpell > longestDrySpell) {
88
+ longestDrySpell = runningDrySpell;
89
+ }
90
+ }
91
+ }
92
+ // Check current streak from end of series
93
+ for (let i = fullDaysSeries.length - 1; i >= 0; i--) {
94
+ if (fullDaysSeries[i].active) {
95
+ currentStreak += 1;
96
+ }
97
+ else {
98
+ break;
99
+ }
100
+ }
101
+ const avgDaily = activeDaysCount > 0 ? Math.round((totalScrobbles / activeDaysCount) * 10) / 10 : 0;
102
+ return {
103
+ user: params.user,
104
+ currentStreakDays: currentStreak,
105
+ longestStreakDays: longestStreak,
106
+ longestDrySpellDays: longestDrySpell,
107
+ activeDaysCount,
108
+ totalDaysEvaluated: fullDaysSeries.length,
109
+ averageDailyScrobbles: avgDaily,
110
+ };
111
+ }
112
+ /**
113
+ * Returns a daily listening heatmap with normalized intensity levels (0..4).
114
+ */
115
+ export async function getListeningHeatmap(config, params, init) {
116
+ const limit = Math.min(1000, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 500));
117
+ const daysCount = Math.max(7, Math.min(365, params.days ?? 90));
118
+ const userService = createUserService(config);
119
+ const recentRes = await userService.getRecentTracks({ user: params.user, limit }, init);
120
+ const rawTracks = recentRes.recenttracks?.track ?? [];
121
+ const tracks = (Array.isArray(rawTracks) ? rawTracks : [rawTracks]).filter((t) => !t['@attr']?.nowplaying);
122
+ const dailyCounts = {};
123
+ let totalScrobbles = 0;
124
+ for (const t of tracks) {
125
+ const uts = Number.parseInt(t.date?.uts ?? '0', 10);
126
+ if (uts > 0) {
127
+ const dateStr = formatUtcDate(uts);
128
+ dailyCounts[dateStr] = (dailyCounts[dateStr] ?? 0) + 1;
129
+ totalScrobbles += 1;
130
+ }
131
+ }
132
+ // Generate day calendar list for the past `daysCount` days ending today
133
+ const now = new Date();
134
+ const calendarDays = [];
135
+ for (let i = daysCount - 1; i >= 0; i--) {
136
+ const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate() - i));
137
+ const dateStr = d.toISOString().slice(0, 10);
138
+ calendarDays.push({ date: dateStr, count: dailyCounts[dateStr] ?? 0 });
139
+ }
140
+ // Determine max and levels
141
+ let maxDailyCount = 0;
142
+ let busiestDay = null;
143
+ for (const day of calendarDays) {
144
+ if (day.count > maxDailyCount) {
145
+ maxDailyCount = day.count;
146
+ busiestDay = { date: day.date, count: day.count };
147
+ }
148
+ }
149
+ const q1 = Math.max(1, Math.round(maxDailyCount * 0.25));
150
+ const q2 = Math.max(2, Math.round(maxDailyCount * 0.5));
151
+ const q3 = Math.max(3, Math.round(maxDailyCount * 0.75));
152
+ const heatmapDays = calendarDays.map((d) => {
153
+ let level = 0;
154
+ if (d.count > 0) {
155
+ if (d.count >= q3)
156
+ level = 4;
157
+ else if (d.count >= q2)
158
+ level = 3;
159
+ else if (d.count >= q1)
160
+ level = 2;
161
+ else
162
+ level = 1;
163
+ }
164
+ return {
165
+ date: d.date,
166
+ count: d.count,
167
+ level,
168
+ };
169
+ });
170
+ return {
171
+ user: params.user,
172
+ totalScrobbles,
173
+ maxDailyCount,
174
+ busiestDay,
175
+ days: heatmapDays,
176
+ };
177
+ }
178
+ //# sourceMappingURL=streaks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"streaks.js","sourceRoot":"","sources":["../../../src/insights/algorithms/streaks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { LastFmConfig } from '../../config.js';
2
+ import type { InsightsSummaryRequest, InsightsSummaryResponse } from '../schemas.js';
3
+ /**
4
+ * Fetches and aggregates listening summary for a user over a given period,
5
+ * including Shannon diversity calculations.
6
+ */
7
+ export declare function getSummary(config: LastFmConfig, params: InsightsSummaryRequest, init?: RequestInit): Promise<InsightsSummaryResponse>;
8
+ //# sourceMappingURL=summary.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,OAAO,KAAK,EAIX,sBAAsB,EACtB,uBAAuB,EAGvB,MAAM,eAAe,CAAA;AAsEtB;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAyDlC"}
@@ -0,0 +1,117 @@
1
+ import { createUserService } from '../../core/services/user.js';
2
+ import { computeDiversity, topNShare } from '../lib/diversity.js';
3
+ import { resolvePeriod } from '../lib/periods.js';
4
+ /**
5
+ * Normalizes an artist from Last.fm getTopArtists payload
6
+ */
7
+ function normalizeArtist(raw) {
8
+ const playcount = Number(raw.playcount ?? 0);
9
+ return {
10
+ name: String(raw.name ?? ''),
11
+ playcount: Number.isNaN(playcount) ? 0 : playcount,
12
+ mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
13
+ url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
14
+ image: Array.isArray(raw.image) ? raw.image : undefined,
15
+ };
16
+ }
17
+ /**
18
+ * Normalizes a track from Last.fm getTopTracks payload
19
+ */
20
+ function normalizeTrack(raw) {
21
+ const playcount = Number(raw.playcount ?? 0);
22
+ const rawArtist = raw.artist;
23
+ const artist = typeof rawArtist === 'object' && rawArtist !== null
24
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
25
+ : String(rawArtist ?? '');
26
+ return {
27
+ name: String(raw.name ?? ''),
28
+ artist,
29
+ playcount: Number.isNaN(playcount) ? 0 : playcount,
30
+ mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
31
+ url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
32
+ image: Array.isArray(raw.image) ? raw.image : undefined,
33
+ };
34
+ }
35
+ /**
36
+ * Normalizes an album from Last.fm getTopAlbums payload
37
+ */
38
+ function normalizeAlbum(raw) {
39
+ const playcount = Number(raw.playcount ?? 0);
40
+ const rawArtist = raw.artist;
41
+ const artist = typeof rawArtist === 'object' && rawArtist !== null
42
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
43
+ : typeof rawArtist === 'string'
44
+ ? rawArtist
45
+ : undefined;
46
+ return {
47
+ name: String(raw.name ?? ''),
48
+ artist,
49
+ playcount: Number.isNaN(playcount) ? 0 : playcount,
50
+ mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
51
+ url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
52
+ image: Array.isArray(raw.image) ? raw.image : undefined,
53
+ };
54
+ }
55
+ /**
56
+ * Normalizes a tag from Last.fm getTopTags payload
57
+ */
58
+ function normalizeTag(raw) {
59
+ const count = Number(raw.count ?? 0);
60
+ return {
61
+ name: String(raw.name ?? ''),
62
+ count: Number.isNaN(count) ? 0 : count,
63
+ url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
64
+ };
65
+ }
66
+ /**
67
+ * Fetches and aggregates listening summary for a user over a given period,
68
+ * including Shannon diversity calculations.
69
+ */
70
+ export async function getSummary(config, params, init) {
71
+ const resolved = resolvePeriod(params.period);
72
+ const userService = createUserService(config);
73
+ const [artistsRes, tracksRes, albumsRes, tagsRes] = await Promise.all([
74
+ userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
75
+ userService.getTopTracks({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
76
+ userService.getTopAlbums({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
77
+ userService.getTopTags({ user: params.user, limit: params.limit }, init),
78
+ ]);
79
+ const topArtists = (artistsRes.topartists?.artist ?? []).map((a) => normalizeArtist(a));
80
+ const topTracks = (tracksRes.toptracks?.track ?? []).map((t) => normalizeTrack(t));
81
+ const topAlbums = (albumsRes.topalbums?.album ?? []).map((a) => normalizeAlbum(a));
82
+ const topTags = (tagsRes.toptags?.tag ?? []).map((t) => normalizeTag(t));
83
+ const totalScrobbles = topArtists.reduce((acc, a) => acc + (a.playcount ?? 0), 0);
84
+ let diversity;
85
+ if (topArtists.length >= 2) {
86
+ const counts = {};
87
+ for (const a of topArtists) {
88
+ if (a.playcount && a.playcount > 0) {
89
+ counts[a.name] = a.playcount;
90
+ }
91
+ }
92
+ const d = computeDiversity(counts);
93
+ diversity = {
94
+ shannon: d.shannon,
95
+ normalized: d.normalized,
96
+ top1Share: topNShare(counts, 1),
97
+ top3Share: topNShare(counts, 3),
98
+ top5Share: topNShare(counts, 5),
99
+ uniqueArtists: d.uniqueCount,
100
+ };
101
+ }
102
+ return {
103
+ user: params.user,
104
+ period: params.period ?? resolved.lastfm,
105
+ label: resolved.label,
106
+ lastfmPeriod: resolved.lastfm,
107
+ from: resolved.from,
108
+ to: resolved.to,
109
+ topArtists,
110
+ topTracks,
111
+ topAlbums,
112
+ topTags,
113
+ totalScrobbles,
114
+ diversity,
115
+ };
116
+ }
117
+ //# sourceMappingURL=summary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/insights/algorithms/summary.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { LastFmConfig } from '../../config.js';
2
+ import type { InsightsTrendsRequest, InsightsTrendsResponse } from '../schemas.js';
3
+ /**
4
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
5
+ * between two time periods for artists, tracks, or albums.
6
+ */
7
+ export declare function getTrends(config: LastFmConfig, params: InsightsTrendsRequest, init?: RequestInit): Promise<InsightsTrendsResponse>;
8
+ //# sourceMappingURL=trends.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/trends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAElF;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,sBAAsB,CAAC,CA6FjC"}
@@ -0,0 +1,96 @@
1
+ import { createUserService } from '../../core/services/user.js';
2
+ import { resolvePeriod } from '../lib/periods.js';
3
+ import { diffRankings } from '../lib/trends.js';
4
+ /**
5
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
6
+ * between two time periods for artists, tracks, or albums.
7
+ */
8
+ export async function getTrends(config, params, init) {
9
+ const userService = createUserService(config);
10
+ const target = params.target ?? 'artists';
11
+ const currentResolved = resolvePeriod(params.currentPeriod ?? '7day');
12
+ const previousResolved = resolvePeriod(params.previousPeriod ?? '1month');
13
+ const limit = params.limit ?? 30;
14
+ let currentItems = [];
15
+ let previousItems = [];
16
+ if (target === 'tracks') {
17
+ const [curRes, prevRes] = await Promise.all([
18
+ userService.getTopTracks({ user: params.user, period: currentResolved.lastfm, limit }, init),
19
+ userService.getTopTracks({ user: params.user, period: previousResolved.lastfm, limit }, init),
20
+ ]);
21
+ currentItems = (curRes.toptracks?.track ?? []).map((t) => {
22
+ const rawArtist = t.artist;
23
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
24
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
25
+ : String(rawArtist ?? '');
26
+ return {
27
+ name: artistName.length > 0 ? `${artistName} - ${t.name}` : t.name,
28
+ playcount: Number(t.playcount ?? 0),
29
+ };
30
+ });
31
+ previousItems = (prevRes.toptracks?.track ?? []).map((t) => {
32
+ const rawArtist = t.artist;
33
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
34
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
35
+ : String(rawArtist ?? '');
36
+ return {
37
+ name: artistName.length > 0 ? `${artistName} - ${t.name}` : t.name,
38
+ playcount: Number(t.playcount ?? 0),
39
+ };
40
+ });
41
+ }
42
+ else if (target === 'albums') {
43
+ const [curRes, prevRes] = await Promise.all([
44
+ userService.getTopAlbums({ user: params.user, period: currentResolved.lastfm, limit }, init),
45
+ userService.getTopAlbums({ user: params.user, period: previousResolved.lastfm, limit }, init),
46
+ ]);
47
+ currentItems = (curRes.topalbums?.album ?? []).map((a) => {
48
+ const rawArtist = a.artist;
49
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
50
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
51
+ : typeof rawArtist === 'string'
52
+ ? rawArtist
53
+ : '';
54
+ return {
55
+ name: artistName.length > 0 ? `${artistName} - ${a.name}` : a.name,
56
+ playcount: Number(a.playcount ?? 0),
57
+ };
58
+ });
59
+ previousItems = (prevRes.topalbums?.album ?? []).map((a) => {
60
+ const rawArtist = a.artist;
61
+ const artistName = typeof rawArtist === 'object' && rawArtist !== null
62
+ ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
63
+ : typeof rawArtist === 'string'
64
+ ? rawArtist
65
+ : '';
66
+ return {
67
+ name: artistName.length > 0 ? `${artistName} - ${a.name}` : a.name,
68
+ playcount: Number(a.playcount ?? 0),
69
+ };
70
+ });
71
+ }
72
+ else {
73
+ // default: artists
74
+ const [curRes, prevRes] = await Promise.all([
75
+ userService.getTopArtists({ user: params.user, period: currentResolved.lastfm, limit }, init),
76
+ userService.getTopArtists({ user: params.user, period: previousResolved.lastfm, limit }, init),
77
+ ]);
78
+ currentItems = (curRes.topartists?.artist ?? []).map((a) => ({
79
+ name: a.name,
80
+ playcount: Number(a.playcount ?? 0),
81
+ }));
82
+ previousItems = (prevRes.topartists?.artist ?? []).map((a) => ({
83
+ name: a.name,
84
+ playcount: Number(a.playcount ?? 0),
85
+ }));
86
+ }
87
+ const diff = diffRankings(currentItems, previousItems, { maxResults: params.maxResults });
88
+ return {
89
+ user: params.user,
90
+ target,
91
+ currentPeriod: currentResolved.lastfm,
92
+ previousPeriod: previousResolved.lastfm,
93
+ ...diff,
94
+ };
95
+ }
96
+ //# sourceMappingURL=trends.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trends.js","sourceRoot":"","sources":["../../../src/insights/algorithms/trends.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAA;AAGhE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC9B,MAAoB,EACpB,MAA6B,EAC7B,IAAkB;IAElB,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,CAAA;IACzC,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,CAAA;IACrE,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,cAAc,IAAI,QAAQ,CAAC,CAAA;IACzE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAA;IAEhC,IAAI,YAAY,GAAiB,EAAE,CAAA;IACnC,IAAI,aAAa,GAAiB,EAAE,CAAA;IAEpC,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;YAC5F,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;SAC7F,CAAC,CAAA;QACF,YAAY,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACxD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAsD,CAAA;YAC1E,MAAM,UAAU,GACf,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;gBAClD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;YAC3B,OAAO;gBACN,IAAI,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAClE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;aACnC,CAAA;QACF,CAAC,CAAC,CAAA;QACF,aAAa,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1D,MAAM,SAAS,GAAG,CAAC,CAAC,MAAsD,CAAA;YAC1E,MAAM,UAAU,GACf,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;gBAClD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAA;YAC3B,OAAO;gBACN,IAAI,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAClE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;aACnC,CAAA;QACF,CAAC,CAAC,CAAA;IACH,CAAC;SAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;YAC5F,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;SAC7F,CAAC,CAAA;QACF,YAAY,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACxD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAsD,CAAA;YAC1E,MAAM,UAAU,GACf,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;gBAClD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC,CAAC,OAAO,SAAS,KAAK,QAAQ;oBAC9B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,EAAE,CAAA;YACP,OAAO;gBACN,IAAI,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAClE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;aACnC,CAAA;QACF,CAAC,CAAC,CAAA;QACF,aAAa,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1D,MAAM,SAAS,GAAG,CAAC,CAAC,MAAsD,CAAA;YAC1E,MAAM,UAAU,GACf,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;gBAClD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC,CAAC,OAAO,SAAS,KAAK,QAAQ;oBAC9B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,EAAE,CAAA;YACP,OAAO;gBACN,IAAI,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAClE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;aACnC,CAAA;QACF,CAAC,CAAC,CAAA;IACH,CAAC;SAAM,CAAC;QACP,mBAAmB;QACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;YAC7F,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC;SAC9F,CAAC,CAAA;QACF,YAAY,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5D,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;SACnC,CAAC,CAAC,CAAA;QACH,aAAa,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;SACnC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IAEzF,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM;QACN,aAAa,EAAE,eAAe,CAAC,MAAM;QACrC,cAAc,EAAE,gBAAgB,CAAC,MAAM;QACvC,GAAG,IAAI;KACP,CAAA;AACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ export * from './schemas.js';
2
+ export * from './service.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
@@ -0,0 +1,3 @@
1
+ export * from './schemas.js';
2
+ export * from './service.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/insights/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * binges.ts — detect binge listening runs from a list of scrobbles.
3
+ *
4
+ * Groups consecutive plays of the same artist or track where the gap
5
+ * between adjacent scrobbles does not exceed maxGapSeconds (default 1h).
6
+ */
7
+ export interface ScrobbleItem {
8
+ readonly artist: string;
9
+ readonly track: string;
10
+ readonly uts: number;
11
+ }
12
+ export type BingesTrackKey = 'artist' | 'track';
13
+ export interface BingeItem {
14
+ readonly artist: string;
15
+ readonly track?: string;
16
+ readonly length: number;
17
+ readonly startUts: number;
18
+ readonly endUts: number;
19
+ readonly durationSeconds: number;
20
+ }
21
+ export interface FindBingesOptions {
22
+ readonly minLength?: number;
23
+ readonly maxGapSeconds?: number;
24
+ readonly trackKey?: BingesTrackKey;
25
+ readonly maxResults?: number;
26
+ }
27
+ /**
28
+ * Finds consecutive listening runs in a chronologically ordered array of scrobbles.
29
+ */
30
+ export declare function findBinges(scrobbles: readonly ScrobbleItem[], options?: FindBingesOptions): BingeItem[];
31
+ //# sourceMappingURL=binges.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"binges.d.ts","sourceRoot":"","sources":["../../../src/insights/lib/binges.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE/C,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,SAAS,EAAE,CAyD3G"}
@@ -0,0 +1,61 @@
1
+ function keyOf(s, k) {
2
+ return k === 'artist' ? s.artist : `${s.artist}::${s.track}`;
3
+ }
4
+ /**
5
+ * Finds consecutive listening runs in a chronologically ordered array of scrobbles.
6
+ */
7
+ export function findBinges(scrobbles, options = {}) {
8
+ const minLength = options.minLength ?? 2;
9
+ const maxGap = options.maxGapSeconds ?? 3600;
10
+ const trackKey = options.trackKey ?? 'artist';
11
+ const out = [];
12
+ let runKey = null;
13
+ let runArtist = null;
14
+ let runTrack = null;
15
+ let runStart = 0;
16
+ let runEnd = 0;
17
+ let runLen = 0;
18
+ const flush = () => {
19
+ if (runLen >= minLength && runKey !== null && runArtist !== null) {
20
+ out.push({
21
+ artist: runArtist,
22
+ ...(trackKey === 'track' && runTrack !== null ? { track: runTrack } : {}),
23
+ length: runLen,
24
+ startUts: runStart,
25
+ endUts: runEnd,
26
+ durationSeconds: runEnd - runStart,
27
+ });
28
+ }
29
+ runKey = null;
30
+ runLen = 0;
31
+ };
32
+ for (const s of scrobbles) {
33
+ const k = keyOf(s, trackKey);
34
+ if (runKey === null) {
35
+ runKey = k;
36
+ runArtist = s.artist;
37
+ runTrack = s.track;
38
+ runStart = s.uts;
39
+ runEnd = s.uts;
40
+ runLen = 1;
41
+ continue;
42
+ }
43
+ if (k !== runKey || s.uts - runEnd > maxGap) {
44
+ flush();
45
+ runKey = k;
46
+ runArtist = s.artist;
47
+ runTrack = s.track;
48
+ runStart = s.uts;
49
+ runEnd = s.uts;
50
+ runLen = 1;
51
+ continue;
52
+ }
53
+ runEnd = s.uts;
54
+ runLen++;
55
+ }
56
+ flush();
57
+ // Sort primarily by run length descending, secondarily by most recent
58
+ out.sort((a, b) => b.length - a.length || b.endUts - a.endUts);
59
+ return options.maxResults !== undefined ? out.slice(0, options.maxResults) : out;
60
+ }
61
+ //# sourceMappingURL=binges.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"binges.js","sourceRoot":"","sources":["../../../src/insights/lib/binges.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * compare.ts — compare two ranked artist lists and compute Jaccard similarity.
3
+ */
4
+ export interface NamedArtistEntry {
5
+ readonly name: string;
6
+ readonly playcount: number;
7
+ }
8
+ export interface CompareArtistsResult {
9
+ readonly aCount: number;
10
+ readonly bCount: number;
11
+ readonly intersection: readonly string[];
12
+ readonly sharedArtists: ReadonlyArray<{
13
+ readonly name: string;
14
+ readonly userAPlaycount: number;
15
+ readonly userBPlaycount: number;
16
+ readonly weight: number;
17
+ }>;
18
+ readonly onlyA: readonly string[];
19
+ readonly onlyB: readonly string[];
20
+ readonly jaccard: number;
21
+ readonly compatibilityScore: number;
22
+ }
23
+ /**
24
+ * Computes Jaccard similarity: |A ∩ B| / |A ∪ B|.
25
+ */
26
+ export declare function jaccard<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): number;
27
+ /**
28
+ * Compares two artist rosters, calculating mutual artist overlap and affinity metrics.
29
+ */
30
+ export declare function compareArtists(a: readonly NamedArtistEntry[], b: readonly NamedArtistEntry[]): CompareArtistsResult;
31
+ //# sourceMappingURL=compare.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../src/insights/lib/compare.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;QAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;QAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KACvB,CAAC,CAAA;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACnC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CASvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,gBAAgB,EAAE,EAAE,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,oBAAoB,CA+CnH"}