@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.
- package/CHANGELOG.md +25 -0
- package/README.md +189 -3
- package/dist/client.d.ts +9 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +13 -1
- package/dist/client.js.map +1 -1
- package/dist/core/canonical-methods.d.ts +25 -0
- package/dist/core/canonical-methods.d.ts.map +1 -0
- package/dist/core/canonical-methods.js +88 -0
- package/dist/core/canonical-methods.js.map +1 -0
- package/dist/core/client.d.ts +33 -0
- package/dist/core/client.d.ts.map +1 -0
- package/dist/core/client.js +48 -0
- package/dist/core/client.js.map +1 -0
- package/dist/core/index.d.ts +6 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +6 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/pagination.d.ts +59 -0
- package/dist/core/pagination.d.ts.map +1 -0
- package/dist/core/pagination.js +93 -0
- package/dist/core/pagination.js.map +1 -0
- package/dist/core/schemas/album.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/album.schemas.js +1 -1
- package/dist/core/schemas/album.schemas.js.map +1 -0
- package/dist/core/schemas/artist.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/artist.schemas.js +1 -1
- package/dist/core/schemas/artist.schemas.js.map +1 -0
- package/dist/core/schemas/auth.schemas.d.ts.map +1 -0
- package/dist/core/schemas/auth.schemas.js.map +1 -0
- package/dist/core/schemas/base/base.entities.schemas.d.ts.map +1 -0
- package/dist/core/schemas/base/base.entities.schemas.js.map +1 -0
- package/dist/core/schemas/base/base.entity-names.schemas.d.ts.map +1 -0
- package/dist/core/schemas/base/base.entity-names.schemas.js.map +1 -0
- package/dist/core/schemas/base/base.metadata.schemas.d.ts.map +1 -0
- package/dist/core/schemas/base/base.metadata.schemas.js.map +1 -0
- package/dist/core/schemas/base/base.pagination.schemas.d.ts.map +1 -0
- package/dist/core/schemas/base/base.pagination.schemas.js.map +1 -0
- package/dist/core/schemas/base/base.primitives.schemas.d.ts.map +1 -0
- package/dist/core/schemas/base/base.primitives.schemas.js.map +1 -0
- package/dist/core/schemas/base/index.d.ts.map +1 -0
- package/dist/core/schemas/base/index.js.map +1 -0
- package/dist/core/schemas/chart.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/chart.schemas.js +1 -1
- package/dist/core/schemas/chart.schemas.js.map +1 -0
- package/dist/core/schemas/geo.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/geo.schemas.js +1 -1
- package/dist/core/schemas/geo.schemas.js.map +1 -0
- package/dist/{services → core/schemas}/index.d.ts +1 -10
- package/dist/core/schemas/index.d.ts.map +1 -0
- package/dist/core/schemas/index.js +11 -0
- package/dist/core/schemas/index.js.map +1 -0
- package/dist/core/schemas/library.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/library.schemas.js +1 -1
- package/dist/core/schemas/library.schemas.js.map +1 -0
- package/dist/core/schemas/tag.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/tag.schemas.js +1 -1
- package/dist/core/schemas/tag.schemas.js.map +1 -0
- package/dist/core/schemas/track.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/track.schemas.js +1 -1
- package/dist/core/schemas/track.schemas.js.map +1 -0
- package/dist/core/schemas/user.schemas.d.ts.map +1 -0
- package/dist/{services → core/schemas}/user.schemas.js +1 -1
- package/dist/core/schemas/user.schemas.js.map +1 -0
- package/dist/{services → core/services}/album.d.ts +2 -2
- package/dist/core/services/album.d.ts.map +1 -0
- package/dist/{services → core/services}/album.js +1 -1
- package/dist/core/services/album.js.map +1 -0
- package/dist/{services → core/services}/artist.d.ts +2 -2
- package/dist/core/services/artist.d.ts.map +1 -0
- package/dist/{services → core/services}/artist.js +1 -1
- package/dist/core/services/artist.js.map +1 -0
- package/dist/{services → core/services}/auth.d.ts +2 -2
- package/dist/core/services/auth.d.ts.map +1 -0
- package/dist/{services → core/services}/auth.js +1 -1
- package/dist/core/services/auth.js.map +1 -0
- package/dist/{services → core/services}/chart.d.ts +2 -2
- package/dist/core/services/chart.d.ts.map +1 -0
- package/dist/{services → core/services}/chart.js +1 -1
- package/dist/core/services/chart.js.map +1 -0
- package/dist/{services → core/services}/geo.d.ts +2 -2
- package/dist/core/services/geo.d.ts.map +1 -0
- package/dist/{services → core/services}/geo.js +1 -1
- package/dist/core/services/geo.js.map +1 -0
- package/dist/core/services/index.d.ts +10 -0
- package/dist/core/services/index.d.ts.map +1 -0
- package/dist/core/services/index.js +10 -0
- package/dist/core/services/index.js.map +1 -0
- package/dist/{services → core/services}/library.d.ts +2 -2
- package/dist/core/services/library.d.ts.map +1 -0
- package/dist/{services → core/services}/library.js +1 -1
- package/dist/core/services/library.js.map +1 -0
- package/dist/{services → core/services}/tag.d.ts +2 -2
- package/dist/core/services/tag.d.ts.map +1 -0
- package/dist/{services → core/services}/tag.js +1 -1
- package/dist/core/services/tag.js.map +1 -0
- package/dist/{services → core/services}/track.d.ts +2 -2
- package/dist/core/services/track.d.ts.map +1 -0
- package/dist/{services → core/services}/track.js +1 -1
- package/dist/core/services/track.js.map +1 -0
- package/dist/{services → core/services}/track.utils.d.ts +2 -2
- package/dist/core/services/track.utils.d.ts.map +1 -0
- package/dist/core/services/track.utils.js.map +1 -0
- package/dist/{services → core/services}/user.d.ts +2 -2
- package/dist/core/services/user.d.ts.map +1 -0
- package/dist/{services → core/services}/user.js +1 -1
- package/dist/core/services/user.js.map +1 -0
- package/dist/entrypoints/album.d.ts +3 -3
- package/dist/entrypoints/album.d.ts.map +1 -1
- package/dist/entrypoints/album.js +2 -2
- package/dist/entrypoints/album.js.map +1 -1
- package/dist/entrypoints/album.schemas.d.ts +2 -1
- package/dist/entrypoints/album.schemas.d.ts.map +1 -1
- package/dist/entrypoints/album.schemas.js +1 -2
- package/dist/entrypoints/album.schemas.js.map +1 -1
- package/dist/entrypoints/artist.d.ts +3 -3
- package/dist/entrypoints/artist.d.ts.map +1 -1
- package/dist/entrypoints/artist.js +2 -2
- package/dist/entrypoints/artist.js.map +1 -1
- package/dist/entrypoints/artist.schemas.d.ts +2 -1
- package/dist/entrypoints/artist.schemas.d.ts.map +1 -1
- package/dist/entrypoints/artist.schemas.js +1 -2
- package/dist/entrypoints/artist.schemas.js.map +1 -1
- package/dist/entrypoints/auth.d.ts +3 -3
- package/dist/entrypoints/auth.d.ts.map +1 -1
- package/dist/entrypoints/auth.js +2 -2
- package/dist/entrypoints/auth.js.map +1 -1
- package/dist/entrypoints/auth.schemas.d.ts +2 -1
- package/dist/entrypoints/auth.schemas.d.ts.map +1 -1
- package/dist/entrypoints/auth.schemas.js +1 -2
- package/dist/entrypoints/auth.schemas.js.map +1 -1
- package/dist/entrypoints/base.schemas.d.ts +2 -1
- package/dist/entrypoints/base.schemas.d.ts.map +1 -1
- package/dist/entrypoints/base.schemas.js +1 -2
- package/dist/entrypoints/base.schemas.js.map +1 -1
- package/dist/entrypoints/chart.d.ts +3 -3
- package/dist/entrypoints/chart.d.ts.map +1 -1
- package/dist/entrypoints/chart.js +2 -2
- package/dist/entrypoints/chart.js.map +1 -1
- package/dist/entrypoints/chart.schemas.d.ts +2 -1
- package/dist/entrypoints/chart.schemas.d.ts.map +1 -1
- package/dist/entrypoints/chart.schemas.js +1 -2
- package/dist/entrypoints/chart.schemas.js.map +1 -1
- package/dist/entrypoints/core.d.ts +5 -0
- package/dist/entrypoints/core.d.ts.map +1 -0
- package/dist/entrypoints/core.js +5 -0
- package/dist/entrypoints/core.js.map +1 -0
- package/dist/entrypoints/core.schemas.d.ts +3 -0
- package/dist/entrypoints/core.schemas.d.ts.map +1 -0
- package/dist/entrypoints/core.schemas.js +2 -0
- package/dist/entrypoints/core.schemas.js.map +1 -0
- package/dist/entrypoints/exporter.d.ts +3 -0
- package/dist/entrypoints/exporter.d.ts.map +1 -0
- package/dist/entrypoints/exporter.js +3 -0
- package/dist/entrypoints/exporter.js.map +1 -0
- package/dist/entrypoints/exporter.schemas.d.ts +3 -0
- package/dist/entrypoints/exporter.schemas.d.ts.map +1 -0
- package/dist/entrypoints/exporter.schemas.js +2 -0
- package/dist/entrypoints/exporter.schemas.js.map +1 -0
- package/dist/entrypoints/geo.d.ts +3 -3
- package/dist/entrypoints/geo.d.ts.map +1 -1
- package/dist/entrypoints/geo.js +2 -2
- package/dist/entrypoints/geo.js.map +1 -1
- package/dist/entrypoints/geo.schemas.d.ts +2 -1
- package/dist/entrypoints/geo.schemas.d.ts.map +1 -1
- package/dist/entrypoints/geo.schemas.js +1 -2
- package/dist/entrypoints/geo.schemas.js.map +1 -1
- package/dist/entrypoints/insights.d.ts +4 -0
- package/dist/entrypoints/insights.d.ts.map +1 -0
- package/dist/entrypoints/insights.js +3 -0
- package/dist/entrypoints/insights.js.map +1 -0
- package/dist/entrypoints/insights.schemas.d.ts +3 -0
- package/dist/entrypoints/insights.schemas.d.ts.map +1 -0
- package/dist/entrypoints/insights.schemas.js +2 -0
- package/dist/entrypoints/insights.schemas.js.map +1 -0
- package/dist/entrypoints/library.d.ts +3 -3
- package/dist/entrypoints/library.d.ts.map +1 -1
- package/dist/entrypoints/library.js +2 -2
- package/dist/entrypoints/library.js.map +1 -1
- package/dist/entrypoints/library.schemas.d.ts +2 -1
- package/dist/entrypoints/library.schemas.d.ts.map +1 -1
- package/dist/entrypoints/library.schemas.js +1 -2
- package/dist/entrypoints/library.schemas.js.map +1 -1
- package/dist/entrypoints/playlists.d.ts +3 -0
- package/dist/entrypoints/playlists.d.ts.map +1 -0
- package/dist/entrypoints/playlists.js +3 -0
- package/dist/entrypoints/playlists.js.map +1 -0
- package/dist/entrypoints/playlists.schemas.d.ts +3 -0
- package/dist/entrypoints/playlists.schemas.d.ts.map +1 -0
- package/dist/entrypoints/playlists.schemas.js +2 -0
- package/dist/entrypoints/playlists.schemas.js.map +1 -0
- package/dist/entrypoints/reports.d.ts +4 -0
- package/dist/entrypoints/reports.d.ts.map +1 -0
- package/dist/entrypoints/reports.js +3 -0
- package/dist/entrypoints/reports.js.map +1 -0
- package/dist/entrypoints/reports.schemas.d.ts +3 -0
- package/dist/entrypoints/reports.schemas.d.ts.map +1 -0
- package/dist/entrypoints/reports.schemas.js +2 -0
- package/dist/entrypoints/reports.schemas.js.map +1 -0
- package/dist/entrypoints/tag.d.ts +3 -3
- package/dist/entrypoints/tag.d.ts.map +1 -1
- package/dist/entrypoints/tag.js +2 -2
- package/dist/entrypoints/tag.js.map +1 -1
- package/dist/entrypoints/tag.schemas.d.ts +2 -1
- package/dist/entrypoints/tag.schemas.d.ts.map +1 -1
- package/dist/entrypoints/tag.schemas.js +1 -2
- package/dist/entrypoints/tag.schemas.js.map +1 -1
- package/dist/entrypoints/track.d.ts +3 -3
- package/dist/entrypoints/track.d.ts.map +1 -1
- package/dist/entrypoints/track.js +2 -2
- package/dist/entrypoints/track.js.map +1 -1
- package/dist/entrypoints/track.schemas.d.ts +2 -1
- package/dist/entrypoints/track.schemas.d.ts.map +1 -1
- package/dist/entrypoints/track.schemas.js +1 -2
- package/dist/entrypoints/track.schemas.js.map +1 -1
- package/dist/entrypoints/user.d.ts +3 -3
- package/dist/entrypoints/user.d.ts.map +1 -1
- package/dist/entrypoints/user.js +2 -2
- package/dist/entrypoints/user.js.map +1 -1
- package/dist/entrypoints/user.schemas.d.ts +2 -1
- package/dist/entrypoints/user.schemas.d.ts.map +1 -1
- package/dist/entrypoints/user.schemas.js +1 -2
- package/dist/entrypoints/user.schemas.js.map +1 -1
- package/dist/exporter/engines/library.d.ts +4 -0
- package/dist/exporter/engines/library.d.ts.map +1 -0
- package/dist/exporter/engines/library.js +34 -0
- package/dist/exporter/engines/library.js.map +1 -0
- package/dist/exporter/engines/loved.d.ts +4 -0
- package/dist/exporter/engines/loved.d.ts.map +1 -0
- package/dist/exporter/engines/loved.js +35 -0
- package/dist/exporter/engines/loved.js.map +1 -0
- package/dist/exporter/engines/scrobbles.d.ts +4 -0
- package/dist/exporter/engines/scrobbles.d.ts.map +1 -0
- package/dist/exporter/engines/scrobbles.js +74 -0
- package/dist/exporter/engines/scrobbles.js.map +1 -0
- package/dist/exporter/formats/csv.d.ts +5 -0
- package/dist/exporter/formats/csv.d.ts.map +1 -0
- package/dist/exporter/formats/csv.js +35 -0
- package/dist/exporter/formats/csv.js.map +1 -0
- package/dist/exporter/formats/jsonl.d.ts +2 -0
- package/dist/exporter/formats/jsonl.d.ts.map +1 -0
- package/dist/exporter/formats/jsonl.js +4 -0
- package/dist/exporter/formats/jsonl.js.map +1 -0
- package/dist/exporter/formats/listenbrainz.d.ts +3 -0
- package/dist/exporter/formats/listenbrainz.d.ts.map +1 -0
- package/dist/exporter/formats/listenbrainz.js +19 -0
- package/dist/exporter/formats/listenbrainz.js.map +1 -0
- package/dist/exporter/index.d.ts +6 -0
- package/dist/exporter/index.d.ts.map +1 -0
- package/dist/exporter/index.js +6 -0
- package/dist/exporter/index.js.map +1 -0
- package/dist/exporter/schemas.d.ts +291 -0
- package/dist/exporter/schemas.d.ts.map +1 -0
- package/dist/exporter/schemas.js +81 -0
- package/dist/exporter/schemas.js.map +1 -0
- package/dist/exporter/service.d.ts +30 -0
- package/dist/exporter/service.d.ts.map +1 -0
- package/dist/exporter/service.js +11 -0
- package/dist/exporter/service.js.map +1 -0
- package/dist/index.d.ts +14 -22
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +17 -15
- package/dist/index.js.map +1 -1
- package/dist/insights/algorithms/album-habits.d.ts +7 -0
- package/dist/insights/algorithms/album-habits.d.ts.map +1 -0
- package/dist/insights/algorithms/album-habits.js +154 -0
- package/dist/insights/algorithms/album-habits.js.map +1 -0
- package/dist/insights/algorithms/binges.d.ts +8 -0
- package/dist/insights/algorithms/binges.d.ts.map +1 -0
- package/dist/insights/algorithms/binges.js +53 -0
- package/dist/insights/algorithms/binges.js.map +1 -0
- package/dist/insights/algorithms/compare.d.ts +8 -0
- package/dist/insights/algorithms/compare.d.ts.map +1 -0
- package/dist/insights/algorithms/compare.js +39 -0
- package/dist/insights/algorithms/compare.js.map +1 -0
- package/dist/insights/algorithms/decay.d.ts +11 -0
- package/dist/insights/algorithms/decay.d.ts.map +1 -0
- package/dist/insights/algorithms/decay.js +154 -0
- package/dist/insights/algorithms/decay.js.map +1 -0
- package/dist/insights/algorithms/discoveries.d.ts +8 -0
- package/dist/insights/algorithms/discoveries.d.ts.map +1 -0
- package/dist/insights/algorithms/discoveries.js +53 -0
- package/dist/insights/algorithms/discoveries.js.map +1 -0
- package/dist/insights/algorithms/genres.d.ts +11 -0
- package/dist/insights/algorithms/genres.d.ts.map +1 -0
- package/dist/insights/algorithms/genres.js +201 -0
- package/dist/insights/algorithms/genres.js.map +1 -0
- package/dist/insights/algorithms/group.d.ts +8 -0
- package/dist/insights/algorithms/group.d.ts.map +1 -0
- package/dist/insights/algorithms/group.js +127 -0
- package/dist/insights/algorithms/group.js.map +1 -0
- package/dist/insights/algorithms/hours.d.ts +8 -0
- package/dist/insights/algorithms/hours.d.ts.map +1 -0
- package/dist/insights/algorithms/hours.js +43 -0
- package/dist/insights/algorithms/hours.js.map +1 -0
- package/dist/insights/algorithms/mood.d.ts +8 -0
- package/dist/insights/algorithms/mood.d.ts.map +1 -0
- package/dist/insights/algorithms/mood.js +53 -0
- package/dist/insights/algorithms/mood.js.map +1 -0
- package/dist/insights/algorithms/now-playing.d.ts +20 -0
- package/dist/insights/algorithms/now-playing.d.ts.map +1 -0
- package/dist/insights/algorithms/now-playing.js +128 -0
- package/dist/insights/algorithms/now-playing.js.map +1 -0
- package/dist/insights/algorithms/obscurity.d.ts +27 -0
- package/dist/insights/algorithms/obscurity.d.ts.map +1 -0
- package/dist/insights/algorithms/obscurity.js +158 -0
- package/dist/insights/algorithms/obscurity.js.map +1 -0
- package/dist/insights/algorithms/personality.d.ts +8 -0
- package/dist/insights/algorithms/personality.d.ts.map +1 -0
- package/dist/insights/algorithms/personality.js +42 -0
- package/dist/insights/algorithms/personality.js.map +1 -0
- package/dist/insights/algorithms/recommendations.d.ts +11 -0
- package/dist/insights/algorithms/recommendations.d.ts.map +1 -0
- package/dist/insights/algorithms/recommendations.js +121 -0
- package/dist/insights/algorithms/recommendations.js.map +1 -0
- package/dist/insights/algorithms/streaks.d.ts +11 -0
- package/dist/insights/algorithms/streaks.d.ts.map +1 -0
- package/dist/insights/algorithms/streaks.js +178 -0
- package/dist/insights/algorithms/streaks.js.map +1 -0
- package/dist/insights/algorithms/summary.d.ts +8 -0
- package/dist/insights/algorithms/summary.d.ts.map +1 -0
- package/dist/insights/algorithms/summary.js +117 -0
- package/dist/insights/algorithms/summary.js.map +1 -0
- package/dist/insights/algorithms/trends.d.ts +8 -0
- package/dist/insights/algorithms/trends.d.ts.map +1 -0
- package/dist/insights/algorithms/trends.js +96 -0
- package/dist/insights/algorithms/trends.js.map +1 -0
- package/dist/insights/index.d.ts +3 -0
- package/dist/insights/index.d.ts.map +1 -0
- package/dist/insights/index.js +3 -0
- package/dist/insights/index.js.map +1 -0
- package/dist/insights/lib/binges.d.ts +31 -0
- package/dist/insights/lib/binges.d.ts.map +1 -0
- package/dist/insights/lib/binges.js +61 -0
- package/dist/insights/lib/binges.js.map +1 -0
- package/dist/insights/lib/compare.d.ts +31 -0
- package/dist/insights/lib/compare.d.ts.map +1 -0
- package/dist/insights/lib/compare.js +68 -0
- package/dist/insights/lib/compare.js.map +1 -0
- package/dist/insights/lib/discoveries.d.ts +17 -0
- package/dist/insights/lib/discoveries.d.ts.map +1 -0
- package/dist/insights/lib/discoveries.js +24 -0
- package/dist/insights/lib/discoveries.js.map +1 -0
- package/dist/insights/lib/diversity.d.ts +28 -0
- package/dist/insights/lib/diversity.d.ts.map +1 -0
- package/dist/insights/lib/diversity.js +39 -0
- package/dist/insights/lib/diversity.js.map +1 -0
- package/dist/insights/lib/hours.d.ts +39 -0
- package/dist/insights/lib/hours.d.ts.map +1 -0
- package/dist/insights/lib/hours.js +66 -0
- package/dist/insights/lib/hours.js.map +1 -0
- package/dist/insights/lib/mood.d.ts +22 -0
- package/dist/insights/lib/mood.d.ts.map +1 -0
- package/dist/insights/lib/mood.js +187 -0
- package/dist/insights/lib/mood.js.map +1 -0
- package/dist/insights/lib/periods.d.ts +17 -0
- package/dist/insights/lib/periods.d.ts.map +1 -0
- package/dist/insights/lib/periods.js +66 -0
- package/dist/insights/lib/periods.js.map +1 -0
- package/dist/insights/lib/personality.d.ts +30 -0
- package/dist/insights/lib/personality.d.ts.map +1 -0
- package/dist/insights/lib/personality.js +131 -0
- package/dist/insights/lib/personality.js.map +1 -0
- package/dist/insights/lib/trends.d.ts +30 -0
- package/dist/insights/lib/trends.d.ts.map +1 -0
- package/dist/insights/lib/trends.js +67 -0
- package/dist/insights/lib/trends.js.map +1 -0
- package/dist/insights/schemas.d.ts +1415 -0
- package/dist/insights/schemas.d.ts.map +1 -0
- package/dist/insights/schemas.js +596 -0
- package/dist/insights/schemas.js.map +1 -0
- package/dist/insights/service.d.ts +191 -0
- package/dist/insights/service.d.ts.map +1 -0
- package/dist/insights/service.js +44 -0
- package/dist/insights/service.js.map +1 -0
- package/dist/playlists/formatters/csv.d.ts +3 -0
- package/dist/playlists/formatters/csv.d.ts.map +1 -0
- package/dist/playlists/formatters/csv.js +18 -0
- package/dist/playlists/formatters/csv.js.map +1 -0
- package/dist/playlists/formatters/m3u.d.ts +3 -0
- package/dist/playlists/formatters/m3u.d.ts.map +1 -0
- package/dist/playlists/formatters/m3u.js +10 -0
- package/dist/playlists/formatters/m3u.js.map +1 -0
- package/dist/playlists/formatters/spotifymatch.d.ts +3 -0
- package/dist/playlists/formatters/spotifymatch.d.ts.map +1 -0
- package/dist/playlists/formatters/spotifymatch.js +4 -0
- package/dist/playlists/formatters/spotifymatch.js.map +1 -0
- package/dist/playlists/generators/generator.d.ts +4 -0
- package/dist/playlists/generators/generator.d.ts.map +1 -0
- package/dist/playlists/generators/generator.js +158 -0
- package/dist/playlists/generators/generator.js.map +1 -0
- package/dist/playlists/index.d.ts +6 -0
- package/dist/playlists/index.d.ts.map +1 -0
- package/dist/playlists/index.js +6 -0
- package/dist/playlists/index.js.map +1 -0
- package/dist/playlists/schemas.d.ts +150 -0
- package/dist/playlists/schemas.d.ts.map +1 -0
- package/dist/playlists/schemas.js +53 -0
- package/dist/playlists/schemas.js.map +1 -0
- package/dist/playlists/service.d.ts +28 -0
- package/dist/playlists/service.d.ts.map +1 -0
- package/dist/playlists/service.js +27 -0
- package/dist/playlists/service.js.map +1 -0
- package/dist/reports/generators/digest.d.ts +4 -0
- package/dist/reports/generators/digest.d.ts.map +1 -0
- package/dist/reports/generators/digest.js +95 -0
- package/dist/reports/generators/digest.js.map +1 -0
- package/dist/reports/generators/milestones.d.ts +4 -0
- package/dist/reports/generators/milestones.d.ts.map +1 -0
- package/dist/reports/generators/milestones.js +59 -0
- package/dist/reports/generators/milestones.js.map +1 -0
- package/dist/reports/generators/wrapped.d.ts +4 -0
- package/dist/reports/generators/wrapped.d.ts.map +1 -0
- package/dist/reports/generators/wrapped.js +179 -0
- package/dist/reports/generators/wrapped.js.map +1 -0
- package/dist/reports/index.d.ts +3 -0
- package/dist/reports/index.d.ts.map +1 -0
- package/dist/reports/index.js +3 -0
- package/dist/reports/index.js.map +1 -0
- package/dist/reports/schemas.d.ts +244 -0
- package/dist/reports/schemas.d.ts.map +1 -0
- package/dist/reports/schemas.js +92 -0
- package/dist/reports/schemas.js.map +1 -0
- package/dist/reports/service.d.ts +30 -0
- package/dist/reports/service.d.ts.map +1 -0
- package/dist/reports/service.js +11 -0
- package/dist/reports/service.js.map +1 -0
- package/package.json +44 -4
- package/dist/services/album.d.ts.map +0 -1
- package/dist/services/album.js.map +0 -1
- package/dist/services/album.schemas.d.ts.map +0 -1
- package/dist/services/album.schemas.js.map +0 -1
- package/dist/services/artist.d.ts.map +0 -1
- package/dist/services/artist.js.map +0 -1
- package/dist/services/artist.schemas.d.ts.map +0 -1
- package/dist/services/artist.schemas.js.map +0 -1
- package/dist/services/auth.d.ts.map +0 -1
- package/dist/services/auth.js.map +0 -1
- package/dist/services/auth.schemas.d.ts.map +0 -1
- package/dist/services/auth.schemas.js.map +0 -1
- package/dist/services/chart.d.ts.map +0 -1
- package/dist/services/chart.js.map +0 -1
- package/dist/services/chart.schemas.d.ts.map +0 -1
- package/dist/services/chart.schemas.js.map +0 -1
- package/dist/services/geo.d.ts.map +0 -1
- package/dist/services/geo.js.map +0 -1
- package/dist/services/geo.schemas.d.ts.map +0 -1
- package/dist/services/geo.schemas.js.map +0 -1
- package/dist/services/index.d.ts.map +0 -1
- package/dist/services/index.js +0 -21
- package/dist/services/index.js.map +0 -1
- package/dist/services/library.d.ts.map +0 -1
- package/dist/services/library.js.map +0 -1
- package/dist/services/library.schemas.d.ts.map +0 -1
- package/dist/services/library.schemas.js.map +0 -1
- package/dist/services/schemas/base.entities.schemas.d.ts.map +0 -1
- package/dist/services/schemas/base.entities.schemas.js.map +0 -1
- package/dist/services/schemas/base.entity-names.schemas.d.ts.map +0 -1
- package/dist/services/schemas/base.entity-names.schemas.js.map +0 -1
- package/dist/services/schemas/base.metadata.schemas.d.ts.map +0 -1
- package/dist/services/schemas/base.metadata.schemas.js.map +0 -1
- package/dist/services/schemas/base.pagination.schemas.d.ts.map +0 -1
- package/dist/services/schemas/base.pagination.schemas.js.map +0 -1
- package/dist/services/schemas/base.primitives.schemas.d.ts.map +0 -1
- package/dist/services/schemas/base.primitives.schemas.js.map +0 -1
- package/dist/services/schemas/index.d.ts.map +0 -1
- package/dist/services/schemas/index.js.map +0 -1
- package/dist/services/tag.d.ts.map +0 -1
- package/dist/services/tag.js.map +0 -1
- package/dist/services/tag.schemas.d.ts.map +0 -1
- package/dist/services/tag.schemas.js.map +0 -1
- package/dist/services/track.d.ts.map +0 -1
- package/dist/services/track.js.map +0 -1
- package/dist/services/track.schemas.d.ts.map +0 -1
- package/dist/services/track.schemas.js.map +0 -1
- package/dist/services/track.utils.d.ts.map +0 -1
- package/dist/services/track.utils.js.map +0 -1
- package/dist/services/user.d.ts.map +0 -1
- package/dist/services/user.js.map +0 -1
- package/dist/services/user.schemas.d.ts.map +0 -1
- package/dist/services/user.schemas.js.map +0 -1
- /package/dist/{services → core/schemas}/album.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/artist.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/auth.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/auth.schemas.js +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.entities.schemas.d.ts +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.entities.schemas.js +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.entity-names.schemas.d.ts +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.entity-names.schemas.js +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.metadata.schemas.d.ts +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.metadata.schemas.js +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.pagination.schemas.d.ts +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.pagination.schemas.js +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.primitives.schemas.d.ts +0 -0
- /package/dist/{services/schemas → core/schemas/base}/base.primitives.schemas.js +0 -0
- /package/dist/{services/schemas → core/schemas/base}/index.d.ts +0 -0
- /package/dist/{services/schemas → core/schemas/base}/index.js +0 -0
- /package/dist/{services → core/schemas}/chart.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/geo.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/library.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/tag.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/track.schemas.d.ts +0 -0
- /package/dist/{services → core/schemas}/user.schemas.d.ts +0 -0
- /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":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAS/D;;GAEG;AACH,SAAS,aAAa,CAAC,UAAkB;IACxC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IACnD,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAoB,EACpB,MAA8B,EAC9B,IAAkB;IAElB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,IAAI,EACJ,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,GAAG,CAAC,CAC5F,CAAA;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAA;IACvF,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAA;IACrD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAA;IAE1G,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACN,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,iBAAiB,EAAE,CAAC;YACpB,iBAAiB,EAAE,CAAC;YACpB,mBAAmB,EAAE,CAAC;YACtB,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,qBAAqB,EAAE,CAAC;SACxB,CAAA;IACF,CAAC;IAED,0BAA0B;IAC1B,MAAM,WAAW,GAA2B,EAAE,CAAA;IAC9C,MAAM,UAAU,GAAa,EAAE,CAAA;IAE/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACnD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACb,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACpB,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;YAClC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QACvD,CAAC;IACF,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACN,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,iBAAiB,EAAE,CAAC;YACpB,iBAAiB,EAAE,CAAC;YACpB,mBAAmB,EAAE,CAAC;YACtB,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,qBAAqB,EAAE,CAAC;SACxB,CAAA;IACF,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAChC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAElE,2BAA2B;IAC3B,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;IACrG,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;IAErG,MAAM,cAAc,GAA4D,EAAE,CAAA;IAElF,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC9C,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACvC,cAAc,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QAChE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,eAAe,GAAG,CAAC,CAAA;IACvB,IAAI,eAAe,GAAG,CAAC,CAAA;IACvB,IAAI,eAAe,GAAG,CAAC,CAAA;IACvB,IAAI,cAAc,GAAG,CAAC,CAAA;IAEtB,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,eAAe,IAAI,CAAC,CAAA;YACpB,cAAc,IAAI,GAAG,CAAC,KAAK,CAAA;YAC3B,aAAa,IAAI,CAAC,CAAA;YAClB,IAAI,aAAa,GAAG,aAAa,EAAE,CAAC;gBACnC,aAAa,GAAG,aAAa,CAAA;YAC9B,CAAC;YACD,eAAe,GAAG,CAAC,CAAA;QACpB,CAAC;aAAM,CAAC;YACP,aAAa,GAAG,CAAC,CAAA;YACjB,eAAe,IAAI,CAAC,CAAA;YACpB,IAAI,eAAe,GAAG,eAAe,EAAE,CAAC;gBACvC,eAAe,GAAG,eAAe,CAAA;YAClC,CAAC;QACF,CAAC;IACF,CAAC;IAED,0CAA0C;IAC1C,KAAK,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC9B,aAAa,IAAI,CAAC,CAAA;QACnB,CAAC;aAAM,CAAC;YACP,MAAK;QACN,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,cAAc,GAAG,eAAe,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnG,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,iBAAiB,EAAE,aAAa;QAChC,iBAAiB,EAAE,aAAa;QAChC,mBAAmB,EAAE,eAAe;QACpC,eAAe;QACf,kBAAkB,EAAE,cAAc,CAAC,MAAM;QACzC,qBAAqB,EAAE,QAAQ;KAC/B,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAoB,EACpB,MAA8B,EAC9B,IAAkB;IAElB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,IAAI,EACJ,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,GAAG,CAAC,CAC5F,CAAA;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAA;IAE/D,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAA;IACvF,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAA;IACrD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAA;IAE1G,MAAM,WAAW,GAA2B,EAAE,CAAA;IAC9C,IAAI,cAAc,GAAG,CAAC,CAAA;IAEtB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACnD,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;YAClC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;YACtD,cAAc,IAAI,CAAC,CAAA;QACpB,CAAC;IACF,CAAC;IAED,wEAAwE;IACxE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,MAAM,YAAY,GAA2C,EAAE,CAAA;IAC/D,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC3F,MAAM,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC5C,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,2BAA2B;IAC3B,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,UAAU,GAA2C,IAAI,CAAA;IAE7D,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,GAAG,CAAC,KAAK,GAAG,aAAa,EAAE,CAAC;YAC/B,aAAa,GAAG,GAAG,CAAC,KAAK,CAAA;YACzB,UAAU,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAA;QAClD,CAAC;IACF,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAA;IACxD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,CAAA;IACvD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAA;IAExD,MAAM,WAAW,GAAwB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/D,IAAI,KAAK,GAAsB,CAAC,CAAA;QAChC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE;gBAAE,KAAK,GAAG,CAAC,CAAA;iBACvB,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE;gBAAE,KAAK,GAAG,CAAC,CAAA;iBAC5B,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE;gBAAE,KAAK,GAAG,CAAC,CAAA;;gBAC5B,KAAK,GAAG,CAAC,CAAA;QACf,CAAC;QACD,OAAO;YACN,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK;SACL,CAAA;IACF,CAAC,CAAC,CAAA;IAEF,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,cAAc;QACd,aAAa;QACb,UAAU;QACV,IAAI,EAAE,WAAW;KACjB,CAAA;AACF,CAAC"}
|
|
@@ -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":"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"}
|
|
@@ -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 @@
|
|
|
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":"AA8BA,SAAS,KAAK,CAAC,CAAe,EAAE,CAAiB;IAChD,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,EAAE,CAAA;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAkC,EAAE,UAA6B,EAAE;IAC7F,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAA;IAC5C,MAAM,QAAQ,GAAmB,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAA;IAE7D,MAAM,GAAG,GAAgB,EAAE,CAAA;IAC3B,IAAI,MAAM,GAAkB,IAAI,CAAA;IAChC,IAAI,SAAS,GAAkB,IAAI,CAAA;IACnC,IAAI,QAAQ,GAAkB,IAAI,CAAA;IAClC,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,MAAM,GAAG,CAAC,CAAA;IAEd,MAAM,KAAK,GAAG,GAAG,EAAE;QAClB,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC;gBACR,MAAM,EAAE,SAAS;gBACjB,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,MAAM;gBACd,eAAe,EAAE,MAAM,GAAG,QAAQ;aAClC,CAAC,CAAA;QACH,CAAC;QACD,MAAM,GAAG,IAAI,CAAA;QACb,MAAM,GAAG,CAAC,CAAA;IACX,CAAC,CAAA;IAED,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC5B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,CAAC,CAAA;YACV,SAAS,GAAG,CAAC,CAAC,MAAM,CAAA;YACpB,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAA;YAClB,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAA;YAChB,MAAM,GAAG,CAAC,CAAC,GAAG,CAAA;YACd,MAAM,GAAG,CAAC,CAAA;YACV,SAAQ;QACT,CAAC;QACD,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,GAAG,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;YAC7C,KAAK,EAAE,CAAA;YACP,MAAM,GAAG,CAAC,CAAA;YACV,SAAS,GAAG,CAAC,CAAC,MAAM,CAAA;YACpB,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAA;YAClB,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAA;YAChB,MAAM,GAAG,CAAC,CAAC,GAAG,CAAA;YACd,MAAM,GAAG,CAAC,CAAA;YACV,SAAQ;QACT,CAAC;QACD,MAAM,GAAG,CAAC,CAAC,GAAG,CAAA;QACd,MAAM,EAAE,CAAA;IACT,CAAC;IACD,KAAK,EAAE,CAAA;IAEP,sEAAsE;IACtE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAA;IAC9D,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AACjF,CAAC"}
|
|
@@ -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"}
|