@ansango/lastfm-api 3.4.0 → 3.5.0

package/dist/insights/algorithms/obscurity.js

@@ -0,0 +1,158 @@
+import { createArtistService } from '../../core/services/artist.js';
+import { createUserService } from '../../core/services/user.js';
+import { resolvePeriod } from '../lib/periods.js';
+/**
+ * Calculates obscurity score (0-100) for a given global listener count.
+ * Logarithmic mapping where:
+ * <= 10 listeners -> 100 (Ultra obscure)
+ * 100 listeners -> ~82
+ * 1,000 listeners -> ~65
+ * 10,000 listeners -> ~47
+ * 100,000 listeners -> ~30
+ * 1,000,000 listeners -> ~12
+ * >= 5,000,000 listeners -> 0 (Mega mainstream)
+ */
+export function calculateArtistObscurity(listeners) {
+    if (listeners <= 1)
+        return 100;
+    const minLog = 1; // log10(10)
+    const maxLog = 6.7; // log10(5,000,000)
+    const logVal = Math.log10(Math.max(1, listeners));
+    const popularity = Math.min(100, Math.max(0, ((logVal - minLog) / (maxLog - minLog)) * 100));
+    return Math.round((100 - popularity) * 100) / 100;
+}
+/**
+ * Categorizes the overall obscurity score.
+ */
+export function categorizeObscurity(score) {
+    if (score >= 80) {
+        return {
+            category: 'Purist Underground',
+            description: 'Deep underground affinity with predominantly niche, indie, and obscure artists.',
+        };
+    }
+    if (score >= 60) {
+        return {
+            category: 'Indie Explorer',
+            description: 'Strong indie and underground inclination with minimal mainstream exposure.',
+        };
+    }
+    if (score >= 40) {
+        return {
+            category: 'Balanced Listener',
+            description: 'Eclectic balance between popular cultural staples and underground acts.',
+        };
+    }
+    if (score >= 20) {
+        return {
+            category: 'Mainstream Enthusiast',
+            description: 'Tilted towards widely recognized artists, established headliners, and chart staples.',
+        };
+    }
+    return {
+        category: 'Chart Chaser',
+        description: 'Dominated by global superstar acts, viral sensations, and mega-hits.',
+    };
+}
+/**
+ * Evaluates the user's top artists against global Last.fm popularity metrics to calculate
+ * an Obscurity / Hipster score.
+ */
+export async function getObscurityScore(config, params, init) {
+    const limit = Math.min(50, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 20));
+    const resolved = resolvePeriod(params.period ?? 'overall');
+    const period = params.period ?? 'overall';
+    const userService = createUserService(config);
+    const artistService = createArtistService(config);
+    // Fetch top artists for user
+    const topRes = await userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit }, init);
+    const rawArtists = topRes.topartists?.artist ?? [];
+    const artistList = Array.isArray(rawArtists) ? rawArtists : [rawArtists];
+    if (artistList.length === 0) {
+        const { category, description } = categorizeObscurity(50);
+        return {
+            user: params.user,
+            period,
+            obscurityScore: 50,
+            category,
+            description,
+            totalArtistsEvaluated: 0,
+            averageGlobalListeners: 0,
+            medianGlobalListeners: 0,
+            hiddenGems: [],
+            mainstreamAnchors: [],
+            artists: [],
+        };
+    }
+    // Fetch global artist info in parallel
+    const infoPromises = artistList.map(async (art) => {
+        const name = art.name;
+        const userPlaycount = Number.parseInt(art.playcount ?? '0', 10) || 0;
+        try {
+            const infoRes = await artistService.getInfo({ artist: name }, init);
+            const globalListeners = Number.parseInt(infoRes.artist?.stats?.listeners ?? '0', 10) || 0;
+            const globalPlaycount = Number.parseInt(infoRes.artist?.stats?.playcount ?? '0', 10) || 0;
+            const obscurityScore = calculateArtistObscurity(globalListeners);
+            return {
+                name,
+                userPlaycount,
+                globalListeners,
+                globalPlaycount,
+                obscurityScore,
+                url: infoRes.artist?.url,
+            };
+        }
+        catch {
+            // Fallback if individual artist info fails
+            const globalListeners = 100000;
+            const obscurityScore = calculateArtistObscurity(globalListeners);
+            return {
+                name,
+                userPlaycount,
+                globalListeners,
+                globalPlaycount: 0,
+                obscurityScore,
+            };
+        }
+    });
+    const evaluatedArtists = await Promise.all(infoPromises);
+    // Calculate weighted obscurity score
+    const totalPlaycount = evaluatedArtists.reduce((acc, a) => acc + a.userPlaycount, 0);
+    let weightedScoreSum = 0;
+    for (const a of evaluatedArtists) {
+        const weight = totalPlaycount > 0 ? a.userPlaycount / totalPlaycount : 1 / evaluatedArtists.length;
+        weightedScoreSum += a.obscurityScore * weight;
+    }
+    const overallObscurity = Math.round(weightedScoreSum * 100) / 100;
+    const { category, description } = categorizeObscurity(overallObscurity);
+    // Global listeners stats
+    const listenerCounts = evaluatedArtists.map((a) => a.globalListeners).sort((a, b) => a - b);
+    const avgListeners = Math.round(listenerCounts.reduce((acc, l) => acc + l, 0) / evaluatedArtists.length);
+    const mid = Math.floor(listenerCounts.length / 2);
+    const medianListeners = listenerCounts.length % 2 !== 0
+        ? listenerCounts[mid]
+        : Math.round((listenerCounts[mid - 1] + listenerCounts[mid]) / 2);
+    // Hidden gems: global listeners < 100,000 (or lowest 3 if all are >= 100k)
+    const gems = evaluatedArtists
+        .filter((a) => a.globalListeners < 100000)
+        .sort((a, b) => a.globalListeners - b.globalListeners);
+    const hiddenGems = gems.length > 0
+        ? gems.slice(0, 5)
+        : [...evaluatedArtists].sort((a, b) => a.globalListeners - b.globalListeners).slice(0, 3);
+    // Mainstream anchors: top 3 highest global listener counts
+    const mainstreamAnchors = [...evaluatedArtists].sort((a, b) => b.globalListeners - a.globalListeners).slice(0, 3);
+    return {
+        user: params.user,
+        period,
+        obscurityScore: overallObscurity,
+        category,
+        description,
+        totalArtistsEvaluated: evaluatedArtists.length,
+        averageGlobalListeners: avgListeners,
+        medianGlobalListeners: medianListeners,
+        hiddenGems,
+        mainstreamAnchors,
+        artists: evaluatedArtists.sort((a, b) => a.obscurityScore - b.obscurityScore),
+    };
+}
+//# sourceMappingURL=obscurity.js.map

package/dist/insights/algorithms/obscurity.js.map

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

package/dist/{services/insights → insights/algorithms}/personality.d.ts

@@ -1,5 +1,5 @@
 import type { LastFmConfig } from '../../config.js';
-import type { InsightsPersonalityRequest, InsightsPersonalityResponse } from '../insights.schemas.js';
+import type { InsightsPersonalityRequest, InsightsPersonalityResponse } from '../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.

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

@@ -0,0 +1 @@
+{"version":3,"file":"personality.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/personality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAK5F;;;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 → insights/algorithms}/personality.js

@@ -1,6 +1,6 @@
+import { ARCHETYPE_INFO, scoreArchetypes } from '../lib/personality.js';
 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,

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

@@ -0,0 +1 @@
+{"version":3,"file":"personality.js","sourceRoot":"","sources":["../../../src/insights/algorithms/personality.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA4B,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEjG,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,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/insights/algorithms/recommendations.d.ts

@@ -0,0 +1,11 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsBridgeArtistsRequest, InsightsBridgeArtistsResponse, InsightsRecommendationsRequest, InsightsRecommendationsResponse } from '../schemas.js';
+/**
+ * Traverses Last.fm similarity graphs from user's top artists to recommend unlistened artists.
+ */
+export declare function getSmartRecommendations(config: LastFmConfig, params: InsightsRecommendationsRequest, init?: RequestInit): Promise<InsightsRecommendationsResponse>;
+/**
+ * Finds artists that bridge two distinct genres or tags.
+ */
+export declare function getBridgeArtists(config: LastFmConfig, params: InsightsBridgeArtistsRequest, init?: RequestInit): Promise<InsightsBridgeArtistsResponse>;
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/insights/algorithms/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/recommendations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAKnD,OAAO,KAAK,EAGX,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,+BAA+B,EAC/B,MAAM,eAAe,CAAA;AAEtB;;GAEG;AACH,wBAAsB,uBAAuB,CAC5C,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,8BAA8B,EACtC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,+BAA+B,CAAC,CA8E1C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,4BAA4B,EACpC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,6BAA6B,CAAC,CAsDxC"}

package/dist/insights/algorithms/recommendations.js

@@ -0,0 +1,121 @@
+import { createArtistService } from '../../core/services/artist.js';
+import { createTagService } from '../../core/services/tag.js';
+import { createUserService } from '../../core/services/user.js';
+import { resolvePeriod } from '../lib/periods.js';
+/**
+ * Traverses Last.fm similarity graphs from user's top artists to recommend unlistened artists.
+ */
+export async function getSmartRecommendations(config, params, init) {
+    const seedLimit = Math.min(20, typeof params.seedLimit === 'string' ? Number.parseInt(params.seedLimit, 10) : (params.seedLimit ?? 10));
+    const limit = Math.min(50, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 15));
+    const period = params.period ?? 'overall';
+    const resolved = resolvePeriod(period);
+    const userService = createUserService(config);
+    const artistService = createArtistService(config);
+    // Fetch top 50 user artists to identify seeds and known roster
+    const topRes = await userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit: 50 }, init);
+    const rawArtists = topRes.topartists?.artist ?? [];
+    const artistList = Array.isArray(rawArtists) ? rawArtists : [rawArtists];
+    const knownArtists = new Set(artistList.map((a) => a.name.toLowerCase().trim()));
+    const seedArtists = artistList.slice(0, seedLimit);
+    const candidateMap = new Map();
+    const promises = seedArtists.map(async (seed, idx) => {
+        const seedName = seed.name;
+        const seedWeight = Math.max(1, seedLimit - idx);
+        try {
+            const simRes = await artistService.getSimilar({ artist: seedName, limit: 20 }, init);
+            const rawSim = simRes.similarartists?.artist ?? [];
+            const simList = Array.isArray(rawSim) ? rawSim : [rawSim];
+            for (const sim of simList) {
+                const candidateName = sim.name;
+                if (!candidateName)
+                    continue;
+                const lower = candidateName.toLowerCase().trim();
+                if (knownArtists.has(lower))
+                    continue;
+                const matchVal = Number.parseFloat(sim.match ?? '0.5') || 0.5;
+                const contribution = matchVal * seedWeight;
+                const existing = candidateMap.get(lower);
+                if (existing) {
+                    existing.score += contribution;
+                    existing.matchedSeeds.add(seedName);
+                }
+                else {
+                    candidateMap.set(lower, {
+                        name: candidateName,
+                        score: contribution,
+                        matchedSeeds: new Set([seedName]),
+                        url: sim.url,
+                    });
+                }
+            }
+        }
+        catch {
+            // ignore failure for individual seed
+        }
+    });
+    await Promise.allSettled(promises);
+    const scoredCandidates = Array.from(candidateMap.values())
+        .map((c) => ({
+        name: c.name,
+        score: Math.round(c.score * 100) / 100,
+        matchedSeeds: Array.from(c.matchedSeeds),
+        url: c.url,
+    }))
+        .sort((a, b) => b.score - a.score || b.matchedSeeds.length - a.matchedSeeds.length)
+        .slice(0, limit);
+    return {
+        user: params.user,
+        seedArtists: seedArtists.map((s) => s.name),
+        totalRecommendations: scoredCandidates.length,
+        recommendations: scoredCandidates,
+    };
+}
+/**
+ * Finds artists that bridge two distinct genres or tags.
+ */
+export async function getBridgeArtists(config, params, init) {
+    const limit = Math.min(50, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 10));
+    const tagService = createTagService(config);
+    const [tagARes, tagBRes] = await Promise.all([
+        tagService.getTopArtists({ tag: params.tagA, limit: 50 }, init),
+        tagService.getTopArtists({ tag: params.tagB, limit: 50 }, init),
+    ]);
+    const rawA = tagARes.topartists?.artist ?? [];
+    const listA = Array.isArray(rawA) ? rawA : [rawA];
+    const rawB = tagBRes.topartists?.artist ?? [];
+    const listB = Array.isArray(rawB) ? rawB : [rawB];
+    const mapA = new Map();
+    listA.forEach((a, idx) => {
+        if (a.name) {
+            mapA.set(a.name.toLowerCase().trim(), { rank: idx + 1, name: a.name, url: a.url });
+        }
+    });
+    const bridges = [];
+    listB.forEach((b, idx) => {
+        if (!b.name)
+            return;
+        const lower = b.name.toLowerCase().trim();
+        const hit = mapA.get(lower);
+        if (hit) {
+            const rankA = hit.rank;
+            const rankB = idx + 1;
+            const combinedScore = Math.round(((1 / rankA + 1 / rankB) / 2) * 10000) / 100;
+            bridges.push({
+                name: hit.name,
+                rankA,
+                rankB,
+                combinedScore,
+                url: hit.url ?? b.url,
+            });
+        }
+    });
+    bridges.sort((a, b) => b.combinedScore - a.combinedScore);
+    return {
+        tagA: params.tagA,
+        tagB: params.tagB,
+        totalBridges: bridges.length,
+        bridgeArtists: bridges.slice(0, limit),
+    };
+}
+//# sourceMappingURL=recommendations.js.map

package/dist/insights/algorithms/recommendations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.js","sourceRoot":"","sources":["../../../src/insights/algorithms/recommendations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAUjD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,MAAoB,EACpB,MAAsC,EACtC,IAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACzB,EAAE,EACF,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CACvG,CAAA;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,EAAE,EACF,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAC3F,CAAA;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,CAAA;IACzC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAEtC,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAEjD,+DAA+D;IAC/D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;IAC/G,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAA;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAExE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAChF,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAElD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoF,CAAA;IAEhH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAA;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,CAAA;QAC/C,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAA;YACpF,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,IAAI,EAAE,CAAA;YAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YAEzD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC3B,MAAM,aAAa,GAAG,GAAG,CAAC,IAAI,CAAA;gBAC9B,IAAI,CAAC,aAAa;oBAAE,SAAQ;gBAC5B,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;gBAChD,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAQ;gBAErC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,GAAG,CAAA;gBAC7D,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAA;gBAE1C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBACxC,IAAI,QAAQ,EAAE,CAAC;oBACd,QAAQ,CAAC,KAAK,IAAI,YAAY,CAAA;oBAC9B,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;gBACpC,CAAC;qBAAM,CAAC;oBACP,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE;wBACvB,IAAI,EAAE,aAAa;wBACnB,KAAK,EAAE,YAAY;wBACnB,YAAY,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;wBACjC,GAAG,EAAE,GAAG,CAAC,GAAG;qBACZ,CAAC,CAAA;gBACH,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,qCAAqC;QACtC,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;IAElC,MAAM,gBAAgB,GAAgC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;SACrF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;QACtC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;QACxC,GAAG,EAAE,CAAC,CAAC,GAAG;KACV,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;SAClF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAEjB,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3C,oBAAoB,EAAE,gBAAgB,CAAC,MAAM;QAC7C,eAAe,EAAE,gBAAgB;KACjC,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,MAAoB,EACpB,MAAoC,EACpC,IAAkB;IAElB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,EAAE,EACF,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAC3F,CAAA;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAE3C,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,UAAU,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;QAC/D,UAAU,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC;KAC/D,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAA;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAEjD,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAA;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAEjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAwD,CAAA;IAC5E,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;QACnF,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,GAA0B,EAAE,CAAA;IAEzC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACxB,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,OAAM;QACnB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,GAAG,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAA;YACtB,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAA;YACrB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;YAC7E,OAAO,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK;gBACL,KAAK;gBACL,aAAa;gBACb,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG;aACrB,CAAC,CAAA;QACH,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAA;IAEzD,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;KACtC,CAAA;AACF,CAAC"}

package/dist/insights/algorithms/streaks.d.ts

@@ -0,0 +1,11 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsHeatmapRequest, InsightsHeatmapResponse, InsightsStreaksRequest, InsightsStreaksResponse } from '../schemas.js';
+/**
+ * Calculates listening streaks (current active streak, longest streak, longest dry spell).
+ */
+export declare function getListeningStreaks(config: LastFmConfig, params: InsightsStreaksRequest, init?: RequestInit): Promise<InsightsStreaksResponse>;
+/**
+ * Returns a daily listening heatmap with normalized intensity levels (0..4).
+ */
+export declare function getListeningHeatmap(config: LastFmConfig, params: InsightsHeatmapRequest, init?: RequestInit): Promise<InsightsHeatmapResponse>;
+//# sourceMappingURL=streaks.d.ts.map

package/dist/insights/algorithms/streaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaks.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/streaks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,OAAO,KAAK,EAEX,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,MAAM,eAAe,CAAA;AAatB;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,uBAAuB,CAAC,CA+GlC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAsElC"}

package/dist/insights/algorithms/streaks.js

@@ -0,0 +1,178 @@
+import { createUserService } from '../../core/services/user.js';
+/**
+ * Formats a UNIX timestamp (seconds) into UTC YYYY-MM-DD.
+ */
+function formatUtcDate(utsSeconds) {
+    const d = new Date(utsSeconds * 1000);
+    const year = d.getUTCFullYear();
+    const month = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Calculates listening streaks (current active streak, longest streak, longest dry spell).
+ */
+export async function getListeningStreaks(config, params, init) {
+    const limit = Math.min(1000, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 500));
+    const userService = createUserService(config);
+    const recentRes = await userService.getRecentTracks({ user: params.user, limit }, init);
+    const rawTracks = recentRes.recenttracks?.track ?? [];
+    const tracks = (Array.isArray(rawTracks) ? rawTracks : [rawTracks]).filter((t) => !t['@attr']?.nowplaying);
+    if (tracks.length === 0) {
+        return {
+            user: params.user,
+            currentStreakDays: 0,
+            longestStreakDays: 0,
+            longestDrySpellDays: 0,
+            activeDaysCount: 0,
+            totalDaysEvaluated: 0,
+            averageDailyScrobbles: 0,
+        };
+    }
+    // Group scrobbles per day
+    const dailyCounts = {};
+    const timestamps = [];
+    for (const t of tracks) {
+        const uts = Number.parseInt(t.date?.uts ?? '0', 10);
+        if (uts > 0) {
+            timestamps.push(uts);
+            const dateStr = formatUtcDate(uts);
+            dailyCounts[dateStr] = (dailyCounts[dateStr] ?? 0) + 1;
+        }
+    }
+    if (timestamps.length === 0) {
+        return {
+            user: params.user,
+            currentStreakDays: 0,
+            longestStreakDays: 0,
+            longestDrySpellDays: 0,
+            activeDaysCount: 0,
+            totalDaysEvaluated: 0,
+            averageDailyScrobbles: 0,
+        };
+    }
+    timestamps.sort((a, b) => a - b);
+    const minDate = new Date(timestamps[0] * 1000);
+    const maxDate = new Date(timestamps[timestamps.length - 1] * 1000);
+    // Set to start of UTC days
+    const cur = new Date(Date.UTC(minDate.getUTCFullYear(), minDate.getUTCMonth(), minDate.getUTCDate()));
+    const end = new Date(Date.UTC(maxDate.getUTCFullYear(), maxDate.getUTCMonth(), maxDate.getUTCDate()));
+    const fullDaysSeries = [];
+    while (cur <= end) {
+        const dateStr = cur.toISOString().slice(0, 10);
+        const count = dailyCounts[dateStr] ?? 0;
+        fullDaysSeries.push({ date: dateStr, active: count > 0, count });
+        cur.setUTCDate(cur.getUTCDate() + 1);
+    }
+    let currentStreak = 0;
+    let longestStreak = 0;
+    let runningStreak = 0;
+    let longestDrySpell = 0;
+    let runningDrySpell = 0;
+    let activeDaysCount = 0;
+    let totalScrobbles = 0;
+    for (const day of fullDaysSeries) {
+        if (day.active) {
+            activeDaysCount += 1;
+            totalScrobbles += day.count;
+            runningStreak += 1;
+            if (runningStreak > longestStreak) {
+                longestStreak = runningStreak;
+            }
+            runningDrySpell = 0;
+        }
+        else {
+            runningStreak = 0;
+            runningDrySpell += 1;
+            if (runningDrySpell > longestDrySpell) {
+                longestDrySpell = runningDrySpell;
+            }
+        }
+    }
+    // Check current streak from end of series
+    for (let i = fullDaysSeries.length - 1; i >= 0; i--) {
+        if (fullDaysSeries[i].active) {
+            currentStreak += 1;
+        }
+        else {
+            break;
+        }
+    }
+    const avgDaily = activeDaysCount > 0 ? Math.round((totalScrobbles / activeDaysCount) * 10) / 10 : 0;
+    return {
+        user: params.user,
+        currentStreakDays: currentStreak,
+        longestStreakDays: longestStreak,
+        longestDrySpellDays: longestDrySpell,
+        activeDaysCount,
+        totalDaysEvaluated: fullDaysSeries.length,
+        averageDailyScrobbles: avgDaily,
+    };
+}
+/**
+ * Returns a daily listening heatmap with normalized intensity levels (0..4).
+ */
+export async function getListeningHeatmap(config, params, init) {
+    const limit = Math.min(1000, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 500));
+    const daysCount = Math.max(7, Math.min(365, params.days ?? 90));
+    const userService = createUserService(config);
+    const recentRes = await userService.getRecentTracks({ user: params.user, limit }, init);
+    const rawTracks = recentRes.recenttracks?.track ?? [];
+    const tracks = (Array.isArray(rawTracks) ? rawTracks : [rawTracks]).filter((t) => !t['@attr']?.nowplaying);
+    const dailyCounts = {};
+    let totalScrobbles = 0;
+    for (const t of tracks) {
+        const uts = Number.parseInt(t.date?.uts ?? '0', 10);
+        if (uts > 0) {
+            const dateStr = formatUtcDate(uts);
+            dailyCounts[dateStr] = (dailyCounts[dateStr] ?? 0) + 1;
+            totalScrobbles += 1;
+        }
+    }
+    // Generate day calendar list for the past `daysCount` days ending today
+    const now = new Date();
+    const calendarDays = [];
+    for (let i = daysCount - 1; i >= 0; i--) {
+        const d = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate() - i));
+        const dateStr = d.toISOString().slice(0, 10);
+        calendarDays.push({ date: dateStr, count: dailyCounts[dateStr] ?? 0 });
+    }
+    // Determine max and levels
+    let maxDailyCount = 0;
+    let busiestDay = null;
+    for (const day of calendarDays) {
+        if (day.count > maxDailyCount) {
+            maxDailyCount = day.count;
+            busiestDay = { date: day.date, count: day.count };
+        }
+    }
+    const q1 = Math.max(1, Math.round(maxDailyCount * 0.25));
+    const q2 = Math.max(2, Math.round(maxDailyCount * 0.5));
+    const q3 = Math.max(3, Math.round(maxDailyCount * 0.75));
+    const heatmapDays = calendarDays.map((d) => {
+        let level = 0;
+        if (d.count > 0) {
+            if (d.count >= q3)
+                level = 4;
+            else if (d.count >= q2)
+                level = 3;
+            else if (d.count >= q1)
+                level = 2;
+            else
+                level = 1;
+        }
+        return {
+            date: d.date,
+            count: d.count,
+            level,
+        };
+    });
+    return {
+        user: params.user,
+        totalScrobbles,
+        maxDailyCount,
+        busiestDay,
+        days: heatmapDays,
+    };
+}
+//# sourceMappingURL=streaks.js.map

package/dist/insights/algorithms/streaks.js.map

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

package/dist/{services/insights → insights/algorithms}/summary.d.ts

@@ -1,5 +1,5 @@
 import type { LastFmConfig } from '../../config.js';
-import type { InsightsSummaryRequest, InsightsSummaryResponse } from '../insights.schemas.js';
+import type { InsightsSummaryRequest, InsightsSummaryResponse } from '../schemas.js';
 /**
  * Fetches and aggregates listening summary for a user over a given period,
  * including Shannon diversity calculations.

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

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

package/dist/{services/insights → insights/algorithms}/summary.js

@@ -1,6 +1,6 @@
-import { createUserService } from '../user.js';
-import { computeDiversity, topNShare } from './lib/diversity.js';
-import { resolvePeriod } from './lib/periods.js';
+import { createUserService } from '../../core/services/user.js';
+import { computeDiversity, topNShare } from '../lib/diversity.js';
+import { resolvePeriod } from '../lib/periods.js';
 /**
  * Normalizes an artist from Last.fm getTopArtists payload
  */

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

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

package/dist/{services/insights → insights/algorithms}/trends.d.ts

@@ -1,5 +1,5 @@
 import type { LastFmConfig } from '../../config.js';
-import type { InsightsTrendsRequest, InsightsTrendsResponse } from '../insights.schemas.js';
+import type { InsightsTrendsRequest, InsightsTrendsResponse } from '../schemas.js';
 /**
  * Calculates ranking differentials (risers, fallers, newcomers, departures)
  * between two time periods for artists, tracks, or albums.

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

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

package/dist/{services/insights → insights/algorithms}/trends.js

@@ -1,6 +1,6 @@
-import { createUserService } from '../user.js';
-import { resolvePeriod } from './lib/periods.js';
-import { diffRankings } from './lib/trends.js';
+import { createUserService } from '../../core/services/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.

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

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

package/dist/insights/index.d.ts

@@ -0,0 +1,3 @@
+export * from './schemas.js';
+export * from './service.js';
+//# sourceMappingURL=index.d.ts.map