@ansango/lastfm-api 3.2.0 → 3.4.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 +61 -0
- package/README.md +66 -22
- package/dist/client.d.ts +2 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +3 -1
- package/dist/client.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 +2 -0
- package/dist/entrypoints/insights.schemas.d.ts.map +1 -0
- package/dist/entrypoints/insights.schemas.js +3 -0
- package/dist/entrypoints/insights.schemas.js.map +1 -0
- package/dist/index.d.ts +4 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/services/album.d.ts +2 -4
- package/dist/services/album.d.ts.map +1 -1
- package/dist/services/album.js.map +1 -1
- package/dist/services/artist.d.ts +2 -4
- package/dist/services/artist.d.ts.map +1 -1
- package/dist/services/artist.js.map +1 -1
- package/dist/services/auth.d.ts +1 -38
- package/dist/services/auth.d.ts.map +1 -1
- package/dist/services/auth.js +1 -19
- package/dist/services/auth.js.map +1 -1
- package/dist/services/auth.schemas.d.ts +0 -13
- package/dist/services/auth.schemas.d.ts.map +1 -1
- package/dist/services/auth.schemas.js +0 -7
- package/dist/services/auth.schemas.js.map +1 -1
- package/dist/services/index.d.ts +2 -0
- package/dist/services/index.d.ts.map +1 -1
- package/dist/services/index.js +2 -0
- package/dist/services/index.js.map +1 -1
- package/dist/services/insights/binges.d.ts +8 -0
- package/dist/services/insights/binges.d.ts.map +1 -0
- package/dist/services/insights/binges.js +53 -0
- package/dist/services/insights/binges.js.map +1 -0
- package/dist/services/insights/compare.d.ts +8 -0
- package/dist/services/insights/compare.d.ts.map +1 -0
- package/dist/services/insights/compare.js +39 -0
- package/dist/services/insights/compare.js.map +1 -0
- package/dist/services/insights/discoveries.d.ts +8 -0
- package/dist/services/insights/discoveries.d.ts.map +1 -0
- package/dist/services/insights/discoveries.js +53 -0
- package/dist/services/insights/discoveries.js.map +1 -0
- package/dist/services/insights/hours.d.ts +8 -0
- package/dist/services/insights/hours.d.ts.map +1 -0
- package/dist/services/insights/hours.js +43 -0
- package/dist/services/insights/hours.js.map +1 -0
- package/dist/services/insights/lib/binges.d.ts +31 -0
- package/dist/services/insights/lib/binges.d.ts.map +1 -0
- package/dist/services/insights/lib/binges.js +61 -0
- package/dist/services/insights/lib/binges.js.map +1 -0
- package/dist/services/insights/lib/compare.d.ts +31 -0
- package/dist/services/insights/lib/compare.d.ts.map +1 -0
- package/dist/services/insights/lib/compare.js +68 -0
- package/dist/services/insights/lib/compare.js.map +1 -0
- package/dist/services/insights/lib/discoveries.d.ts +17 -0
- package/dist/services/insights/lib/discoveries.d.ts.map +1 -0
- package/dist/services/insights/lib/discoveries.js +24 -0
- package/dist/services/insights/lib/discoveries.js.map +1 -0
- package/dist/services/insights/lib/diversity.d.ts +28 -0
- package/dist/services/insights/lib/diversity.d.ts.map +1 -0
- package/dist/services/insights/lib/diversity.js +39 -0
- package/dist/services/insights/lib/diversity.js.map +1 -0
- package/dist/services/insights/lib/hours.d.ts +39 -0
- package/dist/services/insights/lib/hours.d.ts.map +1 -0
- package/dist/services/insights/lib/hours.js +66 -0
- package/dist/services/insights/lib/hours.js.map +1 -0
- package/dist/services/insights/lib/mood.d.ts +22 -0
- package/dist/services/insights/lib/mood.d.ts.map +1 -0
- package/dist/services/insights/lib/mood.js +187 -0
- package/dist/services/insights/lib/mood.js.map +1 -0
- package/dist/services/insights/lib/periods.d.ts +17 -0
- package/dist/services/insights/lib/periods.d.ts.map +1 -0
- package/dist/services/insights/lib/periods.js +66 -0
- package/dist/services/insights/lib/periods.js.map +1 -0
- package/dist/services/insights/lib/personality.d.ts +30 -0
- package/dist/services/insights/lib/personality.d.ts.map +1 -0
- package/dist/services/insights/lib/personality.js +131 -0
- package/dist/services/insights/lib/personality.js.map +1 -0
- package/dist/services/insights/lib/trends.d.ts +30 -0
- package/dist/services/insights/lib/trends.d.ts.map +1 -0
- package/dist/services/insights/lib/trends.js +67 -0
- package/dist/services/insights/lib/trends.js.map +1 -0
- package/dist/services/insights/mood.d.ts +8 -0
- package/dist/services/insights/mood.d.ts.map +1 -0
- package/dist/services/insights/mood.js +53 -0
- package/dist/services/insights/mood.js.map +1 -0
- package/dist/services/insights/now-playing.d.ts +20 -0
- package/dist/services/insights/now-playing.d.ts.map +1 -0
- package/dist/services/insights/now-playing.js +128 -0
- package/dist/services/insights/now-playing.js.map +1 -0
- package/dist/services/insights/personality.d.ts +8 -0
- package/dist/services/insights/personality.d.ts.map +1 -0
- package/dist/services/insights/personality.js +42 -0
- package/dist/services/insights/personality.js.map +1 -0
- package/dist/services/insights/summary.d.ts +8 -0
- package/dist/services/insights/summary.d.ts.map +1 -0
- package/dist/services/insights/summary.js +117 -0
- package/dist/services/insights/summary.js.map +1 -0
- package/dist/services/insights/trends.d.ts +8 -0
- package/dist/services/insights/trends.d.ts.map +1 -0
- package/dist/services/insights/trends.js +96 -0
- package/dist/services/insights/trends.js.map +1 -0
- package/dist/services/insights.d.ts +96 -0
- package/dist/services/insights.d.ts.map +1 -0
- package/dist/services/insights.js +26 -0
- package/dist/services/insights.js.map +1 -0
- package/dist/services/insights.schemas.d.ts +710 -0
- package/dist/services/insights.schemas.d.ts.map +1 -0
- package/dist/services/insights.schemas.js +307 -0
- package/dist/services/insights.schemas.js.map +1 -0
- package/dist/services/track.d.ts +6 -12
- package/dist/services/track.d.ts.map +1 -1
- package/dist/services/track.js.map +1 -1
- package/dist/utils.d.ts +1 -1
- package/package.json +12 -4
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { createUserService } from '../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/services/insights/trends.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import type { LastFmConfig } from '../config.js';
|
|
2
|
+
import type { InsightsBingesRequest, InsightsBingesResponse, InsightsCompareRequest, InsightsCompareResponse, InsightsDiscoveriesRequest, InsightsDiscoveriesResponse, InsightsHoursRequest, InsightsHoursResponse, InsightsMoodRequest, InsightsMoodResponse, InsightsNowPlayingRequest, InsightsNowPlayingResponse, InsightsPersonalityRequest, InsightsPersonalityResponse, InsightsSummaryRequest, InsightsSummaryResponse, InsightsTrendsRequest, InsightsTrendsResponse } from './insights.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
|
+
/**
|
|
93
|
+
* Creates an instance of the Insights service
|
|
94
|
+
*/
|
|
95
|
+
export declare function createInsightsService(config: LastFmConfig): InsightsService;
|
|
96
|
+
//# sourceMappingURL=insights.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"insights.d.ts","sourceRoot":"","sources":["../../src/services/insights.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAUhD,OAAO,KAAK,EACX,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,uBAAuB,CAAA;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEpG;;;;;;;OAOG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,yBAAyB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAA;IAE7G;;;;;;;OAOG;IACH,iBAAiB,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAEvG;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEjG;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAEjG;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,0BAA0B,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAA;IAEhH;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAE3F;;;;;;;OAOG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,0BAA0B,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,2BAA2B,CAAC,CAAA;IAEhH;;;;;;;OAOG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAY3E"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { getBinges } from './insights/binges.js';
|
|
2
|
+
import { compareUsers } from './insights/compare.js';
|
|
3
|
+
import { getDiscoveries } from './insights/discoveries.js';
|
|
4
|
+
import { getHoursHistogram } from './insights/hours.js';
|
|
5
|
+
import { getMood } from './insights/mood.js';
|
|
6
|
+
import { getNowPlaying } from './insights/now-playing.js';
|
|
7
|
+
import { getPersonality } from './insights/personality.js';
|
|
8
|
+
import { getSummary } from './insights/summary.js';
|
|
9
|
+
import { getTrends } from './insights/trends.js';
|
|
10
|
+
/**
|
|
11
|
+
* Creates an instance of the Insights service
|
|
12
|
+
*/
|
|
13
|
+
export function createInsightsService(config) {
|
|
14
|
+
return {
|
|
15
|
+
getSummary: (params, init) => getSummary(config, params, init),
|
|
16
|
+
getNowPlaying: (params, init) => getNowPlaying(config, params, init),
|
|
17
|
+
getHoursHistogram: (params, init) => getHoursHistogram(config, params, init),
|
|
18
|
+
getBinges: (params, init) => getBinges(config, params, init),
|
|
19
|
+
getTrends: (params, init) => getTrends(config, params, init),
|
|
20
|
+
getDiscoveries: (params, init) => getDiscoveries(config, params, init),
|
|
21
|
+
getMood: (params, init) => getMood(config, params, init),
|
|
22
|
+
getPersonality: (params, init) => getPersonality(config, params, init),
|
|
23
|
+
compareUsers: (params, init) => compareUsers(config, params, init),
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=insights.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"insights.js","sourceRoot":"","sources":["../../src/services/insights.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAwHhD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACzD,OAAO;QACN,UAAU,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC9D,aAAa,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACpE,iBAAiB,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC5E,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC5D,SAAS,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC5D,cAAc,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACtE,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACxD,cAAc,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACtE,YAAY,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;KAClE,CAAA;AACF,CAAC"}
|