@ansango/lastfm-api 3.3.0 → 3.4.0

package/dist/services/insights/personality.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsPersonalityRequest, InsightsPersonalityResponse } from '../insights.schemas.js';
+/**
+ * Derives a holistic listener personality archetype (The Devotee, The Explorer,
+ * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
+ */
+export declare function getPersonality(config: LastFmConfig, params: InsightsPersonalityRequest, init?: RequestInit): Promise<InsightsPersonalityResponse>;
+//# sourceMappingURL=personality.d.ts.map

package/dist/services/insights/personality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality.d.ts","sourceRoot":"","sources":["../../../src/services/insights/personality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAA;AAMrG;;;GAGG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,0BAA0B,EAClC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,2BAA2B,CAAC,CAmCtC"}

package/dist/services/insights/personality.js

@@ -0,0 +1,42 @@
+import { getDiscoveries } from './discoveries.js';
+import { getHoursHistogram } from './hours.js';
+import { ARCHETYPE_INFO, scoreArchetypes } from './lib/personality.js';
+import { getSummary } from './summary.js';
+/**
+ * Derives a holistic listener personality archetype (The Devotee, The Explorer,
+ * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
+ */
+export async function getPersonality(config, params, init) {
+    const [summary, histogram, discoveries] = await Promise.all([
+        getSummary(config, { user: params.user, period: '1month', limit: 30 }, init),
+        getHoursHistogram(config, { user: params.user, sinceDays: 30 }, init),
+        getDiscoveries(config, { user: params.user, windowDays: 30, baselineLimit: 200, maxResults: 100 }, init),
+    ]);
+    const features = {
+        totalScrobbles: summary.totalScrobbles,
+        uniqueArtists: summary.topArtists.length,
+        top1Share: summary.diversity?.top1Share ?? 0,
+        top3Share: summary.diversity?.top3Share ?? 0,
+        top5Share: summary.diversity?.top5Share ?? 0,
+        normalizedDiversity: summary.diversity?.normalized ?? 0.5,
+        newArtistsLast30d: discoveries.totalDiscovered,
+        totalArtistsLast30d: summary.topArtists.length,
+        nightHourShare: histogram.nightShare,
+        morningHourShare: histogram.morningShare,
+        weekdayShare: 1 - histogram.weekendShare,
+    };
+    const result = scoreArchetypes(features);
+    const archetype = {
+        id: result.winner,
+        ...ARCHETYPE_INFO[result.winner],
+    };
+    return {
+        user: params.user,
+        winner: result.winner,
+        archetype,
+        scores: result.scores,
+        reasons: [...result.reasons],
+        features,
+    };
+}
+//# sourceMappingURL=personality.js.map

package/dist/services/insights/personality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality.js","sourceRoot":"","sources":["../../../src/services/insights/personality.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,cAAc,EAA4B,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAoB,EACpB,MAAkC,EAClC,IAAkB;IAElB,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3D,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;QAC5E,iBAAiB,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;QACrE,cAAc,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC;KACxG,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAwB;QACrC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;QACxC,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC;QAC5C,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC;QAC5C,mBAAmB,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,IAAI,GAAG;QACzD,iBAAiB,EAAE,WAAW,CAAC,eAAe;QAC9C,mBAAmB,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM;QAC9C,cAAc,EAAE,SAAS,CAAC,UAAU;QACpC,gBAAgB,EAAE,SAAS,CAAC,YAAY;QACxC,YAAY,EAAE,CAAC,GAAG,SAAS,CAAC,YAAY;KACxC,CAAA;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG;QACjB,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;KAChC,CAAA;IAED,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS;QACT,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,QAAQ;KACR,CAAA;AACF,CAAC"}

package/dist/services/insights/summary.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsSummaryRequest, InsightsSummaryResponse } from '../insights.schemas.js';
+/**
+ * Fetches and aggregates listening summary for a user over a given period,
+ * including Shannon diversity calculations.
+ */
+export declare function getSummary(config: LastFmConfig, params: InsightsSummaryRequest, init?: RequestInit): Promise<InsightsSummaryResponse>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/services/insights/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/services/insights/summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAIX,sBAAsB,EACtB,uBAAuB,EAGvB,MAAM,wBAAwB,CAAA;AAyE/B;;;GAGG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAyDlC"}

package/dist/services/insights/summary.js

@@ -0,0 +1,117 @@
+import { createUserService } from '../user.js';
+import { computeDiversity, topNShare } from './lib/diversity.js';
+import { resolvePeriod } from './lib/periods.js';
+/**
+ * Normalizes an artist from Last.fm getTopArtists payload
+ */
+function normalizeArtist(raw) {
+    const playcount = Number(raw.playcount ?? 0);
+    return {
+        name: String(raw.name ?? ''),
+        playcount: Number.isNaN(playcount) ? 0 : playcount,
+        mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+        image: Array.isArray(raw.image) ? raw.image : undefined,
+    };
+}
+/**
+ * Normalizes a track from Last.fm getTopTracks payload
+ */
+function normalizeTrack(raw) {
+    const playcount = Number(raw.playcount ?? 0);
+    const rawArtist = raw.artist;
+    const artist = typeof rawArtist === 'object' && rawArtist !== null
+        ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+        : String(rawArtist ?? '');
+    return {
+        name: String(raw.name ?? ''),
+        artist,
+        playcount: Number.isNaN(playcount) ? 0 : playcount,
+        mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+        image: Array.isArray(raw.image) ? raw.image : undefined,
+    };
+}
+/**
+ * Normalizes an album from Last.fm getTopAlbums payload
+ */
+function normalizeAlbum(raw) {
+    const playcount = Number(raw.playcount ?? 0);
+    const rawArtist = raw.artist;
+    const artist = typeof rawArtist === 'object' && rawArtist !== null
+        ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+        : typeof rawArtist === 'string'
+            ? rawArtist
+            : undefined;
+    return {
+        name: String(raw.name ?? ''),
+        artist,
+        playcount: Number.isNaN(playcount) ? 0 : playcount,
+        mbid: typeof raw.mbid === 'string' && raw.mbid.length > 0 ? raw.mbid : undefined,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+        image: Array.isArray(raw.image) ? raw.image : undefined,
+    };
+}
+/**
+ * Normalizes a tag from Last.fm getTopTags payload
+ */
+function normalizeTag(raw) {
+    const count = Number(raw.count ?? 0);
+    return {
+        name: String(raw.name ?? ''),
+        count: Number.isNaN(count) ? 0 : count,
+        url: typeof raw.url === 'string' && raw.url.length > 0 ? raw.url : undefined,
+    };
+}
+/**
+ * Fetches and aggregates listening summary for a user over a given period,
+ * including Shannon diversity calculations.
+ */
+export async function getSummary(config, params, init) {
+    const resolved = resolvePeriod(params.period);
+    const userService = createUserService(config);
+    const [artistsRes, tracksRes, albumsRes, tagsRes] = await Promise.all([
+        userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
+        userService.getTopTracks({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
+        userService.getTopAlbums({ user: params.user, period: resolved.lastfm, limit: params.limit }, init),
+        userService.getTopTags({ user: params.user, limit: params.limit }, init),
+    ]);
+    const topArtists = (artistsRes.topartists?.artist ?? []).map((a) => normalizeArtist(a));
+    const topTracks = (tracksRes.toptracks?.track ?? []).map((t) => normalizeTrack(t));
+    const topAlbums = (albumsRes.topalbums?.album ?? []).map((a) => normalizeAlbum(a));
+    const topTags = (tagsRes.toptags?.tag ?? []).map((t) => normalizeTag(t));
+    const totalScrobbles = topArtists.reduce((acc, a) => acc + (a.playcount ?? 0), 0);
+    let diversity;
+    if (topArtists.length >= 2) {
+        const counts = {};
+        for (const a of topArtists) {
+            if (a.playcount && a.playcount > 0) {
+                counts[a.name] = a.playcount;
+            }
+        }
+        const d = computeDiversity(counts);
+        diversity = {
+            shannon: d.shannon,
+            normalized: d.normalized,
+            top1Share: topNShare(counts, 1),
+            top3Share: topNShare(counts, 3),
+            top5Share: topNShare(counts, 5),
+            uniqueArtists: d.uniqueCount,
+        };
+    }
+    return {
+        user: params.user,
+        period: params.period ?? resolved.lastfm,
+        label: resolved.label,
+        lastfmPeriod: resolved.lastfm,
+        from: resolved.from,
+        to: resolved.to,
+        topArtists,
+        topTracks,
+        topAlbums,
+        topTags,
+        totalScrobbles,
+        diversity,
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/services/insights/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../src/services/insights/summary.ts"],"names":[],"mappings":"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"}

package/dist/services/insights/trends.d.ts

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsTrendsRequest, InsightsTrendsResponse } from '../insights.schemas.js';
+/**
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
+ * between two time periods for artists, tracks, or albums.
+ */
+export declare function getTrends(config: LastFmConfig, params: InsightsTrendsRequest, init?: RequestInit): Promise<InsightsTrendsResponse>;
+//# sourceMappingURL=trends.d.ts.map

package/dist/services/insights/trends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/services/insights/trends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAK3F;;;GAGG;AACH,wBAAsB,SAAS,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,sBAAsB,CAAC,CA6FjC"}

package/dist/services/insights/trends.js

@@ -0,0 +1,96 @@
+import { createUserService } from '../user.js';
+import { resolvePeriod } from './lib/periods.js';
+import { diffRankings } from './lib/trends.js';
+/**
+ * Calculates ranking differentials (risers, fallers, newcomers, departures)
+ * between two time periods for artists, tracks, or albums.
+ */
+export async function getTrends(config, params, init) {
+    const userService = createUserService(config);
+    const target = params.target ?? 'artists';
+    const currentResolved = resolvePeriod(params.currentPeriod ?? '7day');
+    const previousResolved = resolvePeriod(params.previousPeriod ?? '1month');
+    const limit = params.limit ?? 30;
+    let currentItems = [];
+    let previousItems = [];
+    if (target === 'tracks') {
+        const [curRes, prevRes] = await Promise.all([
+            userService.getTopTracks({ user: params.user, period: currentResolved.lastfm, limit }, init),
+            userService.getTopTracks({ user: params.user, period: previousResolved.lastfm, limit }, init),
+        ]);
+        currentItems = (curRes.toptracks?.track ?? []).map((t) => {
+            const rawArtist = t.artist;
+            const artistName = typeof rawArtist === 'object' && rawArtist !== null
+                ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+                : String(rawArtist ?? '');
+            return {
+                name: artistName.length > 0 ? `${artistName} - ${t.name}` : t.name,
+                playcount: Number(t.playcount ?? 0),
+            };
+        });
+        previousItems = (prevRes.toptracks?.track ?? []).map((t) => {
+            const rawArtist = t.artist;
+            const artistName = typeof rawArtist === 'object' && rawArtist !== null
+                ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+                : String(rawArtist ?? '');
+            return {
+                name: artistName.length > 0 ? `${artistName} - ${t.name}` : t.name,
+                playcount: Number(t.playcount ?? 0),
+            };
+        });
+    }
+    else if (target === 'albums') {
+        const [curRes, prevRes] = await Promise.all([
+            userService.getTopAlbums({ user: params.user, period: currentResolved.lastfm, limit }, init),
+            userService.getTopAlbums({ user: params.user, period: previousResolved.lastfm, limit }, init),
+        ]);
+        currentItems = (curRes.topalbums?.album ?? []).map((a) => {
+            const rawArtist = a.artist;
+            const artistName = typeof rawArtist === 'object' && rawArtist !== null
+                ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+                : typeof rawArtist === 'string'
+                    ? rawArtist
+                    : '';
+            return {
+                name: artistName.length > 0 ? `${artistName} - ${a.name}` : a.name,
+                playcount: Number(a.playcount ?? 0),
+            };
+        });
+        previousItems = (prevRes.topalbums?.album ?? []).map((a) => {
+            const rawArtist = a.artist;
+            const artistName = typeof rawArtist === 'object' && rawArtist !== null
+                ? String(rawArtist.name ?? rawArtist['#text'] ?? '')
+                : typeof rawArtist === 'string'
+                    ? rawArtist
+                    : '';
+            return {
+                name: artistName.length > 0 ? `${artistName} - ${a.name}` : a.name,
+                playcount: Number(a.playcount ?? 0),
+            };
+        });
+    }
+    else {
+        // default: artists
+        const [curRes, prevRes] = await Promise.all([
+            userService.getTopArtists({ user: params.user, period: currentResolved.lastfm, limit }, init),
+            userService.getTopArtists({ user: params.user, period: previousResolved.lastfm, limit }, init),
+        ]);
+        currentItems = (curRes.topartists?.artist ?? []).map((a) => ({
+            name: a.name,
+            playcount: Number(a.playcount ?? 0),
+        }));
+        previousItems = (prevRes.topartists?.artist ?? []).map((a) => ({
+            name: a.name,
+            playcount: Number(a.playcount ?? 0),
+        }));
+    }
+    const diff = diffRankings(currentItems, previousItems, { maxResults: params.maxResults });
+    return {
+        user: params.user,
+        target,
+        currentPeriod: currentResolved.lastfm,
+        previousPeriod: previousResolved.lastfm,
+        ...diff,
+    };
+}
+//# sourceMappingURL=trends.js.map

package/dist/services/insights/trends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trends.js","sourceRoot":"","sources":["../../../src/services/insights/trends.ts"],"names":[],"mappings":"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"}

package/dist/services/insights.d.ts

@@ -0,0 +1,96 @@
+import type { LastFmConfig } from '../config.js';
+import type { InsightsBingesRequest, InsightsBingesResponse, InsightsCompareRequest, InsightsCompareResponse, InsightsDiscoveriesRequest, InsightsDiscoveriesResponse, InsightsHoursRequest, InsightsHoursResponse, InsightsMoodRequest, InsightsMoodResponse, InsightsNowPlayingRequest, InsightsNowPlayingResponse, InsightsPersonalityRequest, InsightsPersonalityResponse, InsightsSummaryRequest, InsightsSummaryResponse, InsightsTrendsRequest, InsightsTrendsResponse } from './insights.schemas.js';
+/**
+ * Insights Service
+ *
+ * Provides high-level derived analytics, summaries, and behavioral insights
+ * computed over Last.fm data.
+ */
+export interface InsightsService {
+    /**
+     * Aggregates a user's listening summary for a given period (top artists, tracks, albums, tags)
+     * and calculates Shannon diversity metrics.
+     *
+     * @param {InsightsSummaryRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsSummaryResponse>}
+     */
+    getSummary: (params: InsightsSummaryRequest, init?: RequestInit) => Promise<InsightsSummaryResponse>;
+    /**
+     * Fetches the user's current (or most recent) track and enriches it with
+     * artist biography and similar artists.
+     *
+     * @param {InsightsNowPlayingRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsNowPlayingResponse>}
+     */
+    getNowPlaying: (params: InsightsNowPlayingRequest, init?: RequestInit) => Promise<InsightsNowPlayingResponse>;
+    /**
+     * Buckets a user's recent scrobbles by hour-of-day (0..23) and weekday (0..6),
+     * calculating diurnal distribution and peak listening times.
+     *
+     * @param {InsightsHoursRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsHoursResponse>}
+     */
+    getHoursHistogram: (params: InsightsHoursRequest, init?: RequestInit) => Promise<InsightsHoursResponse>;
+    /**
+     * Detects binge listening streaks (consecutive plays of the same artist or track)
+     * across a user's recent scrobbles.
+     *
+     * @param {InsightsBingesRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsBingesResponse>}
+     */
+    getBinges: (params: InsightsBingesRequest, init?: RequestInit) => Promise<InsightsBingesResponse>;
+    /**
+     * Calculates ranking differentials (risers, fallers, newcomers, departures)
+     * between two time periods.
+     *
+     * @param {InsightsTrendsRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsTrendsResponse>}
+     */
+    getTrends: (params: InsightsTrendsRequest, init?: RequestInit) => Promise<InsightsTrendsResponse>;
+    /**
+     * Detects newly discovered artists in a recent time window by comparing
+     * against the user's historical baseline roster.
+     *
+     * @param {InsightsDiscoveriesRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsDiscoveriesResponse>}
+     */
+    getDiscoveries: (params: InsightsDiscoveriesRequest, init?: RequestInit) => Promise<InsightsDiscoveriesResponse>;
+    /**
+     * Classifies a user's emotional mood profile (energy vs. valence coordinates,
+     * quadrant, and top genre categories) based on community tags.
+     *
+     * @param {InsightsMoodRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsMoodResponse>}
+     */
+    getMood: (params: InsightsMoodRequest, init?: RequestInit) => Promise<InsightsMoodResponse>;
+    /**
+     * Derives a holistic listener personality archetype (The Devotee, The Explorer,
+     * The Drifter, The DJ, The Nocturnal, The Archivist) based on multidimensional feature vectors.
+     *
+     * @param {InsightsPersonalityRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsPersonalityResponse>}
+     */
+    getPersonality: (params: InsightsPersonalityRequest, init?: RequestInit) => Promise<InsightsPersonalityResponse>;
+    /**
+     * Compares two Last.fm users' listening affinity using Jaccard similarity
+     * over mutual top artist rosters.
+     *
+     * @param {InsightsCompareRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<InsightsCompareResponse>}
+     */
+    compareUsers: (params: InsightsCompareRequest, init?: RequestInit) => Promise<InsightsCompareResponse>;
+}
+/**
+ * Creates an instance of the Insights service
+ */
+export declare function createInsightsService(config: LastFmConfig): InsightsService;
+//# sourceMappingURL=insights.d.ts.map

package/dist/services/insights.d.ts.map

@@ -0,0 +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"}

package/dist/services/insights.js

@@ -0,0 +1,26 @@
+import { getBinges } from './insights/binges.js';
+import { compareUsers } from './insights/compare.js';
+import { getDiscoveries } from './insights/discoveries.js';
+import { getHoursHistogram } from './insights/hours.js';
+import { getMood } from './insights/mood.js';
+import { getNowPlaying } from './insights/now-playing.js';
+import { getPersonality } from './insights/personality.js';
+import { getSummary } from './insights/summary.js';
+import { getTrends } from './insights/trends.js';
+/**
+ * Creates an instance of the Insights service
+ */
+export function createInsightsService(config) {
+    return {
+        getSummary: (params, init) => getSummary(config, params, init),
+        getNowPlaying: (params, init) => getNowPlaying(config, params, init),
+        getHoursHistogram: (params, init) => getHoursHistogram(config, params, init),
+        getBinges: (params, init) => getBinges(config, params, init),
+        getTrends: (params, init) => getTrends(config, params, init),
+        getDiscoveries: (params, init) => getDiscoveries(config, params, init),
+        getMood: (params, init) => getMood(config, params, init),
+        getPersonality: (params, init) => getPersonality(config, params, init),
+        compareUsers: (params, init) => compareUsers(config, params, init),
+    };
+}
+//# sourceMappingURL=insights.js.map

package/dist/services/insights.js.map

@@ -0,0 +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"}