@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,191 @@
1
+ import type { LastFmConfig } from '../config.js';
2
+ import type { InsightsAlbumHabitsRequest, InsightsAlbumHabitsResponse, InsightsBingesRequest, InsightsBingesResponse, InsightsBridgeArtistsRequest, InsightsBridgeArtistsResponse, InsightsCompareRequest, InsightsCompareResponse, InsightsCompareTasteGroupRequest, InsightsCompareTasteGroupResponse, InsightsDiscoveriesRequest, InsightsDiscoveriesResponse, InsightsForgottenFavoritesRequest, InsightsForgottenFavoritesResponse, InsightsGenreBreakdownRequest, InsightsGenreBreakdownResponse, InsightsGenreEvolutionRequest, InsightsGenreEvolutionResponse, InsightsHeatmapRequest, InsightsHeatmapResponse, InsightsHoursRequest, InsightsHoursResponse, InsightsMoodRequest, InsightsMoodResponse, InsightsNowPlayingRequest, InsightsNowPlayingResponse, InsightsObscurityRequest, InsightsObscurityResponse, InsightsObsessionsRequest, InsightsObsessionsResponse, InsightsPersonalityRequest, InsightsPersonalityResponse, InsightsRecommendationsRequest, InsightsRecommendationsResponse, InsightsStreaksRequest, InsightsStreaksResponse, InsightsSummaryRequest, InsightsSummaryResponse, InsightsTrendsRequest, InsightsTrendsResponse } from './schemas.js';
3
+ /**
4
+ * Insights Service
5
+ *
6
+ * Provides high-level derived analytics, summaries, and behavioral insights
7
+ * computed over Last.fm data.
8
+ */
9
+ export interface InsightsService {
10
+ /**
11
+ * Aggregates a user's listening summary for a given period (top artists, tracks, albums, tags)
12
+ * and calculates Shannon diversity metrics.
13
+ *
14
+ * @param {InsightsSummaryRequest} params
15
+ * @param {RequestInit} [init]
16
+ * @returns {Promise<InsightsSummaryResponse>}
17
+ */
18
+ getSummary: (params: InsightsSummaryRequest, init?: RequestInit) => Promise<InsightsSummaryResponse>;
19
+ /**
20
+ * Fetches the user's current (or most recent) track and enriches it with
21
+ * artist biography and similar artists.
22
+ *
23
+ * @param {InsightsNowPlayingRequest} params
24
+ * @param {RequestInit} [init]
25
+ * @returns {Promise<InsightsNowPlayingResponse>}
26
+ */
27
+ getNowPlaying: (params: InsightsNowPlayingRequest, init?: RequestInit) => Promise<InsightsNowPlayingResponse>;
28
+ /**
29
+ * Buckets a user's recent scrobbles by hour-of-day (0..23) and weekday (0..6),
30
+ * calculating diurnal distribution and peak listening times.
31
+ *
32
+ * @param {InsightsHoursRequest} params
33
+ * @param {RequestInit} [init]
34
+ * @returns {Promise<InsightsHoursResponse>}
35
+ */
36
+ getHoursHistogram: (params: InsightsHoursRequest, init?: RequestInit) => Promise<InsightsHoursResponse>;
37
+ /**
38
+ * Detects binge listening streaks (consecutive plays of the same artist or track)
39
+ * across a user's recent scrobbles.
40
+ *
41
+ * @param {InsightsBingesRequest} params
42
+ * @param {RequestInit} [init]
43
+ * @returns {Promise<InsightsBingesResponse>}
44
+ */
45
+ getBinges: (params: InsightsBingesRequest, init?: RequestInit) => Promise<InsightsBingesResponse>;
46
+ /**
47
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
48
+ * between two time periods.
49
+ *
50
+ * @param {InsightsTrendsRequest} params
51
+ * @param {RequestInit} [init]
52
+ * @returns {Promise<InsightsTrendsResponse>}
53
+ */
54
+ getTrends: (params: InsightsTrendsRequest, init?: RequestInit) => Promise<InsightsTrendsResponse>;
55
+ /**
56
+ * Detects newly discovered artists in a recent time window by comparing
57
+ * against the user's historical baseline roster.
58
+ *
59
+ * @param {InsightsDiscoveriesRequest} params
60
+ * @param {RequestInit} [init]
61
+ * @returns {Promise<InsightsDiscoveriesResponse>}
62
+ */
63
+ getDiscoveries: (params: InsightsDiscoveriesRequest, init?: RequestInit) => Promise<InsightsDiscoveriesResponse>;
64
+ /**
65
+ * Classifies a user's emotional mood profile (energy vs. valence coordinates,
66
+ * quadrant, and top genre categories) based on community tags.
67
+ *
68
+ * @param {InsightsMoodRequest} params
69
+ * @param {RequestInit} [init]
70
+ * @returns {Promise<InsightsMoodResponse>}
71
+ */
72
+ getMood: (params: InsightsMoodRequest, init?: RequestInit) => Promise<InsightsMoodResponse>;
73
+ /**
74
+ * Derives a holistic listener personality archetype (The Devotee, The Explorer,
75
+ * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
76
+ *
77
+ * @param {InsightsPersonalityRequest} params
78
+ * @param {RequestInit} [init]
79
+ * @returns {Promise<InsightsPersonalityResponse>}
80
+ */
81
+ getPersonality: (params: InsightsPersonalityRequest, init?: RequestInit) => Promise<InsightsPersonalityResponse>;
82
+ /**
83
+ * Compares two Last.fm users' listening affinity using Jaccard similarity
84
+ * over mutual top artist rosters.
85
+ *
86
+ * @param {InsightsCompareRequest} params
87
+ * @param {RequestInit} [init]
88
+ * @returns {Promise<InsightsCompareResponse>}
89
+ */
90
+ compareUsers: (params: InsightsCompareRequest, init?: RequestInit) => Promise<InsightsCompareResponse>;
91
+ /**
92
+ * Evaluates a user's top artists against global Last.fm popularity metrics to calculate
93
+ * an Obscurity / Hipster score, highlighting hidden gems and mainstream anchors.
94
+ *
95
+ * @param {InsightsObscurityRequest} params
96
+ * @param {RequestInit} [init]
97
+ * @returns {Promise<InsightsObscurityResponse>}
98
+ */
99
+ getObscurityScore: (params: InsightsObscurityRequest, init?: RequestInit) => Promise<InsightsObscurityResponse>;
100
+ /**
101
+ * Identifies historical favorite artists that the user has stopped listening to
102
+ * in the recent period.
103
+ *
104
+ * @param {InsightsForgottenFavoritesRequest} params
105
+ * @param {RequestInit} [init]
106
+ * @returns {Promise<InsightsForgottenFavoritesResponse>}
107
+ */
108
+ getForgottenFavorites: (params: InsightsForgottenFavoritesRequest, init?: RequestInit) => Promise<InsightsForgottenFavoritesResponse>;
109
+ /**
110
+ * Detects intense listening obsession episodes where a single artist or track heavily dominates
111
+ * a sliding listening window.
112
+ *
113
+ * @param {InsightsObsessionsRequest} params
114
+ * @param {RequestInit} [init]
115
+ * @returns {Promise<InsightsObsessionsResponse>}
116
+ */
117
+ getObsessions: (params: InsightsObsessionsRequest, init?: RequestInit) => Promise<InsightsObsessionsResponse>;
118
+ /**
119
+ * Calculates consecutive daily listening streaks, longest continuous streaks, and dry spells.
120
+ *
121
+ * @param {InsightsStreaksRequest} params
122
+ * @param {RequestInit} [init]
123
+ * @returns {Promise<InsightsStreaksResponse>}
124
+ */
125
+ getListeningStreaks: (params: InsightsStreaksRequest, init?: RequestInit) => Promise<InsightsStreaksResponse>;
126
+ /**
127
+ * Generates a daily listening heatmap formatted with normalized intensity levels (0..4)
128
+ * suitable for GitHub-style calendar contribution representations.
129
+ *
130
+ * @param {InsightsHeatmapRequest} params
131
+ * @param {RequestInit} [init]
132
+ * @returns {Promise<InsightsHeatmapResponse>}
133
+ */
134
+ getListeningHeatmap: (params: InsightsHeatmapRequest, init?: RequestInit) => Promise<InsightsHeatmapResponse>;
135
+ /**
136
+ * Analyzes sequential listening history to assess album completion, cohesion score (0-100),
137
+ * and listener profile ('Album Purist' vs 'Playlist Shuffler').
138
+ *
139
+ * @param {InsightsAlbumHabitsRequest} params
140
+ * @param {RequestInit} [init]
141
+ * @returns {Promise<InsightsAlbumHabitsResponse>}
142
+ */
143
+ getAlbumHabits: (params: InsightsAlbumHabitsRequest, init?: RequestInit) => Promise<InsightsAlbumHabitsResponse>;
144
+ /**
145
+ * Computes normalized genre breakdown, filtering out noise tags and calculating
146
+ * Herfindahl-Hirschman (HHI) concentration metrics.
147
+ *
148
+ * @param {InsightsGenreBreakdownRequest} params
149
+ * @param {RequestInit} [init]
150
+ * @returns {Promise<InsightsGenreBreakdownResponse>}
151
+ */
152
+ getGenreBreakdown: (params: InsightsGenreBreakdownRequest, init?: RequestInit) => Promise<InsightsGenreBreakdownResponse>;
153
+ /**
154
+ * Tracks shifts in genre percentage shares between two time periods.
155
+ *
156
+ * @param {InsightsGenreEvolutionRequest} params
157
+ * @param {RequestInit} [init]
158
+ * @returns {Promise<InsightsGenreEvolutionResponse>}
159
+ */
160
+ getGenreEvolution: (params: InsightsGenreEvolutionRequest, init?: RequestInit) => Promise<InsightsGenreEvolutionResponse>;
161
+ /**
162
+ * Traverses Last.fm similarity graphs from user's top artists to recommend unlistened artists.
163
+ *
164
+ * @param {InsightsRecommendationsRequest} params
165
+ * @param {RequestInit} [init]
166
+ * @returns {Promise<InsightsRecommendationsResponse>}
167
+ */
168
+ getSmartRecommendations: (params: InsightsRecommendationsRequest, init?: RequestInit) => Promise<InsightsRecommendationsResponse>;
169
+ /**
170
+ * Finds artists that bridge two distinct genres or tags by computing rank overlap.
171
+ *
172
+ * @param {InsightsBridgeArtistsRequest} params
173
+ * @param {RequestInit} [init]
174
+ * @returns {Promise<InsightsBridgeArtistsResponse>}
175
+ */
176
+ getBridgeArtists: (params: InsightsBridgeArtistsRequest, init?: RequestInit) => Promise<InsightsBridgeArtistsResponse>;
177
+ /**
178
+ * Compares 3 to 10 users simultaneously, computing pairwise Jaccard compatibility,
179
+ * consensus artists heard across the group, and identifying taste anchors and outliers.
180
+ *
181
+ * @param {InsightsCompareTasteGroupRequest} params
182
+ * @param {RequestInit} [init]
183
+ * @returns {Promise<InsightsCompareTasteGroupResponse>}
184
+ */
185
+ compareTasteGroup: (params: InsightsCompareTasteGroupRequest, init?: RequestInit) => Promise<InsightsCompareTasteGroupResponse>;
186
+ }
187
+ /**
188
+ * Creates an instance of the Insights service
189
+ */
190
+ export declare function createInsightsService(config: LastFmConfig): InsightsService;
191
+ //# sourceMappingURL=service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/insights/service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ import { getAlbumHabits } from './algorithms/album-habits.js';
2
+ import { getBinges } from './algorithms/binges.js';
3
+ import { compareUsers } from './algorithms/compare.js';
4
+ import { getForgottenFavorites, getObsessions } from './algorithms/decay.js';
5
+ import { getDiscoveries } from './algorithms/discoveries.js';
6
+ import { getGenreBreakdown, getGenreEvolution } from './algorithms/genres.js';
7
+ import { compareTasteGroup } from './algorithms/group.js';
8
+ import { getHoursHistogram } from './algorithms/hours.js';
9
+ import { getMood } from './algorithms/mood.js';
10
+ import { getNowPlaying } from './algorithms/now-playing.js';
11
+ import { getObscurityScore } from './algorithms/obscurity.js';
12
+ import { getPersonality } from './algorithms/personality.js';
13
+ import { getBridgeArtists, getSmartRecommendations } from './algorithms/recommendations.js';
14
+ import { getListeningHeatmap, getListeningStreaks } from './algorithms/streaks.js';
15
+ import { getSummary } from './algorithms/summary.js';
16
+ import { getTrends } from './algorithms/trends.js';
17
+ /**
18
+ * Creates an instance of the Insights service
19
+ */
20
+ export function createInsightsService(config) {
21
+ return {
22
+ getSummary: (params, init) => getSummary(config, params, init),
23
+ getNowPlaying: (params, init) => getNowPlaying(config, params, init),
24
+ getHoursHistogram: (params, init) => getHoursHistogram(config, params, init),
25
+ getBinges: (params, init) => getBinges(config, params, init),
26
+ getTrends: (params, init) => getTrends(config, params, init),
27
+ getDiscoveries: (params, init) => getDiscoveries(config, params, init),
28
+ getMood: (params, init) => getMood(config, params, init),
29
+ getPersonality: (params, init) => getPersonality(config, params, init),
30
+ compareUsers: (params, init) => compareUsers(config, params, init),
31
+ getObscurityScore: (params, init) => getObscurityScore(config, params, init),
32
+ getForgottenFavorites: (params, init) => getForgottenFavorites(config, params, init),
33
+ getObsessions: (params, init) => getObsessions(config, params, init),
34
+ getListeningStreaks: (params, init) => getListeningStreaks(config, params, init),
35
+ getListeningHeatmap: (params, init) => getListeningHeatmap(config, params, init),
36
+ getAlbumHabits: (params, init) => getAlbumHabits(config, params, init),
37
+ getGenreBreakdown: (params, init) => getGenreBreakdown(config, params, init),
38
+ getGenreEvolution: (params, init) => getGenreEvolution(config, params, init),
39
+ getSmartRecommendations: (params, init) => getSmartRecommendations(config, params, init),
40
+ getBridgeArtists: (params, init) => getBridgeArtists(config, params, init),
41
+ compareTasteGroup: (params, init) => compareTasteGroup(config, params, init),
42
+ };
43
+ }
44
+ //# sourceMappingURL=service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/insights/service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { PlaylistTrackItem } from '../schemas.js';
2
+ export declare function formatCsv(tracks: PlaylistTrackItem[]): string;
3
+ //# sourceMappingURL=csv.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/playlists/formatters/csv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAStD,wBAAgB,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAY7D"}
@@ -0,0 +1,18 @@
1
+ function escapeCsv(val) {
2
+ if (val.includes(',') || val.includes('"') || val.includes('\n')) {
3
+ return `"${val.replace(/"/g, '""')}"`;
4
+ }
5
+ return val;
6
+ }
7
+ export function formatCsv(tracks) {
8
+ const header = 'Artist,Track,Album,DurationSeconds,SourceReason';
9
+ const rows = tracks.map((t) => [
10
+ escapeCsv(t.artist),
11
+ escapeCsv(t.name),
12
+ escapeCsv(t.album ?? ''),
13
+ String(t.duration ?? ''),
14
+ escapeCsv(t.sourceReason ?? ''),
15
+ ].join(','));
16
+ return [header, ...rows].join('\n');
17
+ }
18
+ //# sourceMappingURL=csv.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/playlists/formatters/csv.ts"],"names":[],"mappings":"AAEA,SAAS,SAAS,CAAC,GAAW;IAC7B,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAA;IACtC,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAA2B;IACpD,MAAM,MAAM,GAAG,iDAAiD,CAAA;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7B;QACC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QACnB,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QACjB,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxB,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxB,SAAS,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;KAC/B,CAAC,IAAI,CAAC,GAAG,CAAC,CACX,CAAA;IACD,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { PlaylistTrackItem } from '../schemas.js';
2
+ export declare function formatM3U(tracks: PlaylistTrackItem[], title?: string): string;
3
+ //# sourceMappingURL=m3u.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"m3u.d.ts","sourceRoot":"","sources":["../../../src/playlists/formatters/m3u.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,wBAAgB,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,KAAK,SAAa,GAAG,MAAM,CAQjF"}
@@ -0,0 +1,10 @@
1
+ export function formatM3U(tracks, title = 'Playlist') {
2
+ const lines = ['#EXTM3U', `#PLAYLIST:${title}`];
3
+ for (const t of tracks) {
4
+ const duration = t.duration && t.duration > 0 ? t.duration : -1;
5
+ lines.push(`#EXTINF:${duration},${t.artist} - ${t.name}`);
6
+ lines.push(`${t.artist} - ${t.name}.mp3`);
7
+ }
8
+ return lines.join('\n');
9
+ }
10
+ //# sourceMappingURL=m3u.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"m3u.js","sourceRoot":"","sources":["../../../src/playlists/formatters/m3u.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,MAA2B,EAAE,KAAK,GAAG,UAAU;IACxE,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,aAAa,KAAK,EAAE,CAAC,CAAA;IAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/D,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACzD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { PlaylistTrackItem } from '../schemas.js';
2
+ export declare function formatSpotifyQueries(tracks: PlaylistTrackItem[]): string[];
3
+ //# sourceMappingURL=spotifymatch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spotifymatch.d.ts","sourceRoot":"","sources":["../../../src/playlists/formatters/spotifymatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAE1E"}
@@ -0,0 +1,4 @@
1
+ export function formatSpotifyQueries(tracks) {
2
+ return tracks.map((t) => `track:${t.name} artist:${t.artist}`);
3
+ }
4
+ //# sourceMappingURL=spotifymatch.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"spotifymatch.js","sourceRoot":"","sources":["../../../src/playlists/formatters/spotifymatch.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,MAA2B;IAC/D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;AAC/D,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { LastFmConfig } from '../../config.js';
2
+ import type { PlaylistsGenerateRequest, PlaylistsGenerateResponse } from '../schemas.js';
3
+ export declare function generatePlaylist(config: LastFmConfig, params: PlaylistsGenerateRequest, init?: RequestInit): Promise<PlaylistsGenerateResponse>;
4
+ //# sourceMappingURL=generator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/playlists/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAMnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAqB,MAAM,eAAe,CAAA;AAE3G,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,wBAAwB,EAChC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,yBAAyB,CAAC,CAmKpC"}
@@ -0,0 +1,158 @@
1
+ import { createArtistService } from '../../core/services/artist.js';
2
+ import { createUserService } from '../../core/services/user.js';
3
+ import { formatCsv } from '../formatters/csv.js';
4
+ import { formatM3U } from '../formatters/m3u.js';
5
+ import { formatSpotifyQueries } from '../formatters/spotifymatch.js';
6
+ export async function generatePlaylist(config, params, init) {
7
+ const limit = Math.min(100, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 25));
8
+ const userService = createUserService(config);
9
+ const artistService = createArtistService(config);
10
+ let title = 'Generated Playlist';
11
+ let description = '';
12
+ const tracks = [];
13
+ if (params.mode === 'heavy-rotation') {
14
+ title = `${params.user}'s Heavy Rotation`;
15
+ description = 'Current top rotation tracks from the last 30 days.';
16
+ const topRes = await userService.getTopTracks({ user: params.user, period: '1month', limit }, init);
17
+ const raw = topRes.toptracks?.track ?? [];
18
+ const list = Array.isArray(raw) ? raw : [raw];
19
+ for (const t of list) {
20
+ const artist = typeof t.artist === 'object' && t.artist !== null ? (t.artist.name ?? '') : String(t.artist ?? '');
21
+ const name = t.name ?? '';
22
+ if (name && artist) {
23
+ tracks.push({
24
+ name,
25
+ artist,
26
+ duration: Number.parseInt(String(t.duration ?? '0'), 10) || undefined,
27
+ sourceReason: `Top track (playcount: ${t.playcount})`,
28
+ });
29
+ }
30
+ }
31
+ }
32
+ else if (params.mode === 'time-capsule') {
33
+ title = `${params.user}'s Time Capsule`;
34
+ description = 'Forgotten favorites from past years with zero recent plays.';
35
+ const [histRes, recentRes] = await Promise.all([
36
+ userService.getTopTracks({ user: params.user, period: '12month', limit: 100 }, init),
37
+ userService.getRecentTracks({ user: params.user, limit: 200 }, init),
38
+ ]);
39
+ const rawRecent = recentRes.recenttracks?.track ?? [];
40
+ const recentList = Array.isArray(rawRecent) ? rawRecent : [rawRecent];
41
+ const recentTrackKeys = new Set(recentList.map((t) => {
42
+ const art = typeof t.artist === 'object' && t.artist !== null
43
+ ? (t.artist['#text'] ?? t.artist.name ?? '')
44
+ : String(t.artist ?? '');
45
+ return `${(t.name ?? '').toLowerCase()}:::${art.toLowerCase()}`;
46
+ }));
47
+ const rawHist = histRes.toptracks?.track ?? [];
48
+ const histList = Array.isArray(rawHist) ? rawHist : [rawHist];
49
+ for (const t of histList) {
50
+ const artist = typeof t.artist === 'object' && t.artist !== null ? (t.artist.name ?? '') : String(t.artist ?? '');
51
+ const name = t.name ?? '';
52
+ const key = `${name.toLowerCase()}:::${artist.toLowerCase()}`;
53
+ if (name && artist && !recentTrackKeys.has(key)) {
54
+ tracks.push({
55
+ name,
56
+ artist,
57
+ duration: Number.parseInt(String(t.duration ?? '0'), 10) || undefined,
58
+ sourceReason: 'Historic staple with 0 recent plays in last 90 days',
59
+ });
60
+ if (tracks.length >= limit)
61
+ break;
62
+ }
63
+ }
64
+ }
65
+ else if (params.mode === 'deep-cuts') {
66
+ title = `${params.user}'s Deep Cuts & B-Sides`;
67
+ description = 'Lesser-known tracks by your top artists.';
68
+ const topArtistsRes = await userService.getTopArtists({ user: params.user, period: 'overall', limit: 5 }, init);
69
+ const rawArtists = topArtistsRes.topartists?.artist ?? [];
70
+ const topArtistList = Array.isArray(rawArtists) ? rawArtists : [rawArtists];
71
+ for (const art of topArtistList) {
72
+ if (!art.name)
73
+ continue;
74
+ try {
75
+ const topTracksRes = await artistService.getTopTracks({ artist: art.name, limit: 30 }, init);
76
+ const rawTracks = topTracksRes.toptracks?.track ?? [];
77
+ const artTracks = Array.isArray(rawTracks) ? rawTracks : [rawTracks];
78
+ // Take tracks from index 10 onwards (the deep cuts)
79
+ const deepSlice = artTracks.slice(10, 16);
80
+ for (const dt of deepSlice) {
81
+ const dtArtist = typeof dt.artist === 'object' && dt.artist !== null ? (dt.artist.name ?? art.name) : art.name;
82
+ if (dt.name) {
83
+ tracks.push({
84
+ name: dt.name,
85
+ artist: dtArtist,
86
+ sourceReason: `Deep cut by ${art.name}`,
87
+ });
88
+ }
89
+ }
90
+ }
91
+ catch {
92
+ // skip on failure
93
+ }
94
+ if (tracks.length >= limit)
95
+ break;
96
+ }
97
+ }
98
+ else if (params.mode === 'discovery-radar') {
99
+ title = `${params.user}'s Discovery Radar`;
100
+ description = 'Fresh track recommendations from similar artists you haven’t scrobbled yet.';
101
+ const topArtistsRes = await userService.getTopArtists({ user: params.user, period: 'overall', limit: 30 }, init);
102
+ const rawArtists = topArtistsRes.topartists?.artist ?? [];
103
+ const allUserArtists = Array.isArray(rawArtists) ? rawArtists : [rawArtists];
104
+ const knownSet = new Set(allUserArtists.map((a) => (a.name ?? '').toLowerCase().trim()));
105
+ const seeds = allUserArtists.slice(0, 5);
106
+ for (const seed of seeds) {
107
+ if (!seed.name)
108
+ continue;
109
+ try {
110
+ const simRes = await artistService.getSimilar({ artist: seed.name, limit: 10 }, init);
111
+ const rawSim = simRes.similarartists?.artist ?? [];
112
+ const simList = Array.isArray(rawSim) ? rawSim : [rawSim];
113
+ for (const sim of simList) {
114
+ if (!sim.name || knownSet.has(sim.name.toLowerCase().trim()))
115
+ continue;
116
+ knownSet.add(sim.name.toLowerCase().trim()); // avoid duplicate suggestions
117
+ const simTop = await artistService.getTopTracks({ artist: sim.name, limit: 2 }, init);
118
+ const rawST = simTop.toptracks?.track ?? [];
119
+ const stList = Array.isArray(rawST) ? rawST : [rawST];
120
+ for (const st of stList) {
121
+ if (st.name) {
122
+ tracks.push({
123
+ name: st.name,
124
+ artist: sim.name,
125
+ sourceReason: `Recommended via similarity to ${seed.name}`,
126
+ });
127
+ }
128
+ }
129
+ if (tracks.length >= limit)
130
+ break;
131
+ }
132
+ }
133
+ catch {
134
+ // skip on failure
135
+ }
136
+ if (tracks.length >= limit)
137
+ break;
138
+ }
139
+ }
140
+ const finalTracks = tracks.slice(0, limit);
141
+ const m3u = formatM3U(finalTracks, title);
142
+ const csv = formatCsv(finalTracks);
143
+ const spotifyQueries = formatSpotifyQueries(finalTracks);
144
+ return {
145
+ user: params.user,
146
+ mode: params.mode,
147
+ title,
148
+ description,
149
+ totalTracks: finalTracks.length,
150
+ tracks: finalTracks,
151
+ formats: {
152
+ m3u,
153
+ csv,
154
+ spotifyQueries,
155
+ },
156
+ };
157
+ }
158
+ //# sourceMappingURL=generator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../src/playlists/generators/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAGpE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,MAAoB,EACpB,MAAgC,EAChC,IAAkB;IAElB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,GAAG,EACH,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAC3F,CAAA;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAEjD,IAAI,KAAK,GAAG,oBAAoB,CAAA;IAChC,IAAI,WAAW,GAAG,EAAE,CAAA;IACpB,MAAM,MAAM,GAAwB,EAAE,CAAA;IAEtC,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACtC,KAAK,GAAG,GAAG,MAAM,CAAC,IAAI,mBAAmB,CAAA;QACzC,WAAW,GAAG,oDAAoD,CAAA;QAElE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAA;QACnG,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAA;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAE7C,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;YACjH,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;YACzB,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,MAAM;oBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS;oBACrE,YAAY,EAAE,yBAAyB,CAAC,CAAC,SAAS,GAAG;iBACrD,CAAC,CAAA;YACH,CAAC;QACF,CAAC;IACF,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAC3C,KAAK,GAAG,GAAG,MAAM,CAAC,IAAI,iBAAiB,CAAA;QACvC,WAAW,GAAG,6DAA6D,CAAA;QAE3E,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9C,WAAW,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC;YACpF,WAAW,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC;SACpE,CAAC,CAAA;QAEF,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAA;QACrD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QACrE,MAAM,eAAe,GAAG,IAAI,GAAG,CAC9B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,MAAM,GAAG,GACR,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI;gBAChD,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC5C,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;YAC1B,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,WAAW,EAAE,EAAE,CAAA;QAChE,CAAC,CAAC,CACF,CAAA;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAA;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAE7D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;YACjH,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;YACzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC,WAAW,EAAE,EAAE,CAAA;YAC7D,IAAI,IAAI,IAAI,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,MAAM;oBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,SAAS;oBACrE,YAAY,EAAE,qDAAqD;iBACnE,CAAC,CAAA;gBACF,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;oBAAE,MAAK;YAClC,CAAC;QACF,CAAC;IACF,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACxC,KAAK,GAAG,GAAG,MAAM,CAAC,IAAI,wBAAwB,CAAA;QAC9C,WAAW,GAAG,0CAA0C,CAAA;QAExD,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC/G,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAA;QACzD,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAE3E,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,SAAQ;YACvB,IAAI,CAAC;gBACJ,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;gBAC5F,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAA;gBACrD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;gBAEpE,oDAAoD;gBACpD,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;gBACzC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;oBAC5B,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC,MAAM,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAA;oBAC9G,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;wBACb,MAAM,CAAC,IAAI,CAAC;4BACX,IAAI,EAAE,EAAE,CAAC,IAAI;4BACb,MAAM,EAAE,QAAQ;4BAChB,YAAY,EAAE,eAAe,GAAG,CAAC,IAAI,EAAE;yBACvC,CAAC,CAAA;oBACH,CAAC;gBACF,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,kBAAkB;YACnB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAK;QAClC,CAAC;IACF,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC9C,KAAK,GAAG,GAAG,MAAM,CAAC,IAAI,oBAAoB,CAAA;QAC1C,WAAW,GAAG,6EAA6E,CAAA;QAE3F,MAAM,aAAa,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;QAChH,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAA;QACzD,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QAC5E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACxF,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,IAAI;gBAAE,SAAQ;YACxB,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;gBACrF,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,IAAI,EAAE,CAAA;gBAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;gBAEzD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;wBAAE,SAAQ;oBACtE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA,CAAC,8BAA8B;oBAE1E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;oBACrF,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAA;oBAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;oBACrD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;wBACzB,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;4BACb,MAAM,CAAC,IAAI,CAAC;gCACX,IAAI,EAAE,EAAE,CAAC,IAAI;gCACb,MAAM,EAAE,GAAG,CAAC,IAAI;gCAChB,YAAY,EAAE,iCAAiC,IAAI,CAAC,IAAI,EAAE;6BAC1D,CAAC,CAAA;wBACH,CAAC;oBACF,CAAC;oBACD,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;wBAAE,MAAK;gBAClC,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,kBAAkB;YACnB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAK;QAClC,CAAC;IACF,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAA;IAClC,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAA;IAExD,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK;QACL,WAAW;QACX,WAAW,EAAE,WAAW,CAAC,MAAM;QAC/B,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE;YACR,GAAG;YACH,GAAG;YACH,cAAc;SACd;KACD,CAAA;AACF,CAAC"}
@@ -0,0 +1,6 @@
1
+ export * from './formatters/csv.js';
2
+ export * from './formatters/m3u.js';
3
+ export * from './formatters/spotifymatch.js';
4
+ export * from './schemas.js';
5
+ export * from './service.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playlists/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}
@@ -0,0 +1,6 @@
1
+ export * from './formatters/csv.js';
2
+ export * from './formatters/m3u.js';
3
+ export * from './formatters/spotifymatch.js';
4
+ export * from './schemas.js';
5
+ export * from './service.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/playlists/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}