@ansango/lastfm-api 3.3.0 → 3.5.0

package/dist/insights/algorithms/genres.js

@@ -0,0 +1,201 @@
+import { createArtistService } from '../../core/services/artist.js';
+import { createUserService } from '../../core/services/user.js';
+import { resolvePeriod } from '../lib/periods.js';
+const NOISE_TAGS = new Set([
+    'seen live',
+    'favorites',
+    'favourite',
+    'favourites',
+    'spotify',
+    'awesome',
+    'beautiful',
+    'love',
+    'all',
+    'albums i own',
+    'under 2000 listeners',
+    'my favorites',
+    'tracks i like',
+    'female vocalists',
+    'male vocalists',
+    'singer-songwriter',
+    'cover',
+    'soundtrack',
+    'ost',
+    'instrumental',
+    'classic',
+    '80s',
+    '90s',
+    '70s',
+    '60s',
+    '00s',
+    '2000s',
+    '2010s',
+    '2020s',
+    'american',
+    'british',
+    'uk',
+    'us',
+    'german',
+    'swedish',
+    'japanese',
+    'spanish',
+]);
+function isCleanGenre(tag) {
+    const lower = tag.toLowerCase().trim();
+    if (lower.length < 2 || lower.length > 30)
+        return false;
+    if (NOISE_TAGS.has(lower))
+        return false;
+    if (/^\d+s?$/.test(lower))
+        return false;
+    return true;
+}
+function categorizeSpecialization(hhi) {
+    if (hhi >= 2500) {
+        return {
+            specializationLevel: 'Highly Concentrated',
+            description: 'Strong specialization in one or two primary musical genres.',
+        };
+    }
+    if (hhi >= 1500) {
+        return {
+            specializationLevel: 'Moderately Diversified',
+            description: 'Healthy rotation across several favorite genres with moderate focus.',
+        };
+    }
+    return {
+        specializationLevel: 'Musical Omnivore',
+        description: 'Wide, eclectically distributed taste spanning many diverse musical styles.',
+    };
+}
+async function computeRawGenreBreakdown(config, user, period, artistLimit, init) {
+    const resolved = resolvePeriod(period);
+    const userService = createUserService(config);
+    const artistService = createArtistService(config);
+    const topRes = await userService.getTopArtists({ user, period: resolved.lastfm, limit: artistLimit }, init);
+    const rawArtists = topRes.topartists?.artist ?? [];
+    const artistList = Array.isArray(rawArtists) ? rawArtists : [rawArtists];
+    const genreMap = new Map();
+    let totalWeight = 0;
+    const promises = artistList.map(async (art) => {
+        const name = art.name;
+        const playcount = Number.parseInt(art.playcount ?? '0', 10) || 1;
+        try {
+            const tagRes = await artistService.getTopTags({ artist: name }, init);
+            const rawTags = tagRes.toptags?.tag ?? [];
+            const tagList = (Array.isArray(rawTags) ? rawTags : [rawTags]).filter((t) => typeof t.name === 'string');
+            const cleanTags = tagList
+                .map((t) => t.name.toLowerCase().trim())
+                .filter(isCleanGenre)
+                .slice(0, 5);
+            for (let i = 0; i < cleanTags.length; i++) {
+                const tag = cleanTags[i];
+                const rankWeight = 5 - i;
+                const weight = playcount * rankWeight;
+                genreMap.set(tag, (genreMap.get(tag) ?? 0) + weight);
+            }
+        }
+        catch {
+            // ignore tag fetch failure for individual artist
+        }
+    });
+    await Promise.allSettled(promises);
+    for (const w of genreMap.values()) {
+        totalWeight += w;
+    }
+    return { totalWeight, genreMap };
+}
+/**
+ * Computes normalized genre breakdown, noise-filtering meta tags and calculating HHI concentration.
+ */
+export async function getGenreBreakdown(config, params, init) {
+    const limit = Math.min(50, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 20));
+    const topGenresLimit = Math.min(30, typeof params.topGenresLimit === 'string'
+        ? Number.parseInt(params.topGenresLimit, 10)
+        : (params.topGenresLimit ?? 10));
+    const period = params.period ?? 'overall';
+    const { totalWeight, genreMap } = await computeRawGenreBreakdown(config, params.user, period, limit, init);
+    if (totalWeight === 0 || genreMap.size === 0) {
+        const { specializationLevel, description } = categorizeSpecialization(0);
+        return {
+            user: params.user,
+            period,
+            totalGenresDetected: 0,
+            hhiIndex: 0,
+            specializationLevel,
+            description,
+            genres: [],
+        };
+    }
+    const sortedGenres = Array.from(genreMap.entries()).sort((a, b) => b[1] - a[1]);
+    const allEntries = sortedGenres.map(([name, weight]) => ({
+        name,
+        weight,
+        percentage: Math.round((weight / totalWeight) * 10000) / 100,
+    }));
+    // Calculate HHI
+    let hhi = 0;
+    for (const g of allEntries) {
+        hhi += g.percentage * g.percentage;
+    }
+    const hhiIndex = Math.round(hhi);
+    const { specializationLevel, description } = categorizeSpecialization(hhiIndex);
+    return {
+        user: params.user,
+        period,
+        totalGenresDetected: allEntries.length,
+        hhiIndex,
+        specializationLevel,
+        description,
+        genres: allEntries.slice(0, topGenresLimit),
+    };
+}
+/**
+ * Tracks shifts in genre percentage shares between two periods.
+ */
+export async function getGenreEvolution(config, params, init) {
+    const limit = Math.min(50, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 20));
+    const currentPeriod = params.currentPeriod ?? '1month';
+    const previousPeriod = params.previousPeriod ?? '12month';
+    const [curData, prevData] = await Promise.all([
+        computeRawGenreBreakdown(config, params.user, currentPeriod, limit, init),
+        computeRawGenreBreakdown(config, params.user, previousPeriod, limit, init),
+    ]);
+    const curPcts = new Map();
+    if (curData.totalWeight > 0) {
+        for (const [name, w] of curData.genreMap.entries()) {
+            curPcts.set(name, Math.round((w / curData.totalWeight) * 10000) / 100);
+        }
+    }
+    const prevPcts = new Map();
+    if (prevData.totalWeight > 0) {
+        for (const [name, w] of prevData.genreMap.entries()) {
+            prevPcts.set(name, Math.round((w / prevData.totalWeight) * 10000) / 100);
+        }
+    }
+    const allKeys = new Set([...curPcts.keys(), ...prevPcts.keys()]);
+    const shifts = [];
+    const newGenres = [];
+    for (const name of allKeys) {
+        const currentPct = curPcts.get(name) ?? 0;
+        const previousPct = prevPcts.get(name) ?? 0;
+        const deltaPct = Math.round((currentPct - previousPct) * 100) / 100;
+        if (previousPct === 0 && currentPct > 0) {
+            newGenres.push({ name, currentPct });
+        }
+        if (currentPct > 0 || previousPct > 0) {
+            shifts.push({ name, currentPct, previousPct, deltaPct });
+        }
+    }
+    const risingGenres = shifts.filter((s) => s.deltaPct > 0).sort((a, b) => b.deltaPct - a.deltaPct);
+    const fadingGenres = shifts.filter((s) => s.deltaPct < 0).sort((a, b) => a.deltaPct - b.deltaPct);
+    return {
+        user: params.user,
+        currentPeriod,
+        previousPeriod,
+        risingGenres: risingGenres.slice(0, 10),
+        fadingGenres: fadingGenres.slice(0, 10),
+        newGenres: newGenres.sort((a, b) => b.currentPct - a.currentPct).slice(0, 10),
+    };
+}
+//# sourceMappingURL=genres.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsCompareTasteGroupRequest, InsightsCompareTasteGroupResponse } from '../schemas.js';
+/**
+ * Compares 3-10 users simultaneously, computing pairwise Jaccard affinities,
+ * group consensus artists, and identifying group outliers and taste anchors.
+ */
+export declare function compareTasteGroup(config: LastFmConfig, params: InsightsCompareTasteGroupRequest, init?: RequestInit): Promise<InsightsCompareTasteGroupResponse>;
+//# sourceMappingURL=group.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAGX,gCAAgC,EAChC,iCAAiC,EACjC,MAAM,eAAe,CAAA;AAEtB;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,gCAAgC,EACxC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,iCAAiC,CAAC,CA6I5C"}

package/dist/insights/algorithms/group.js

@@ -0,0 +1,127 @@
+import { createUserService } from '../../core/services/user.js';
+import { resolvePeriod } from '../lib/periods.js';
+/**
+ * Compares 3-10 users simultaneously, computing pairwise Jaccard affinities,
+ * group consensus artists, and identifying group outliers and taste anchors.
+ */
+export async function compareTasteGroup(config, params, init) {
+    const limit = Math.min(100, typeof params.limit === 'string' ? Number.parseInt(params.limit, 10) : (params.limit ?? 50));
+    const period = params.period ?? 'overall';
+    const resolved = resolvePeriod(period);
+    const userService = createUserService(config);
+    const users = Array.from(new Set(params.users));
+    // Fetch top artists for all users in parallel
+    const userArtistRosters = await Promise.all(users.map(async (u) => {
+        try {
+            const res = await userService.getTopArtists({ user: u, period: resolved.lastfm, limit }, init);
+            const raw = res.topartists?.artist ?? [];
+            const list = Array.isArray(raw) ? raw : [raw];
+            const artistMap = new Map();
+            for (const a of list) {
+                if (a.name) {
+                    artistMap.set(a.name.toLowerCase().trim(), {
+                        name: a.name,
+                        playcount: Number.parseInt(a.playcount ?? '0', 10) || 1,
+                    });
+                }
+            }
+            return { user: u, artistMap };
+        }
+        catch {
+            return { user: u, artistMap: new Map() };
+        }
+    }));
+    // Pairwise Jaccard calculations
+    const pairwiseMatrix = [];
+    const userTotalScores = {};
+    for (const u of users) {
+        userTotalScores[u] = { sumScore: 0, pairCount: 0 };
+    }
+    for (let i = 0; i < userArtistRosters.length; i++) {
+        for (let j = i + 1; j < userArtistRosters.length; j++) {
+            const u1 = userArtistRosters[i];
+            const u2 = userArtistRosters[j];
+            const set1 = new Set(u1.artistMap.keys());
+            const set2 = new Set(u2.artistMap.keys());
+            const intersection = new Set([...set1].filter((x) => set2.has(x)));
+            const union = new Set([...set1, ...set2]);
+            const jaccard = union.size > 0 ? Math.round((intersection.size / union.size) * 1000) / 1000 : 0;
+            const compatibilityScore = Math.round(jaccard * 100);
+            pairwiseMatrix.push({
+                userA: u1.user,
+                userB: u2.user,
+                jaccard,
+                compatibilityScore,
+                sharedCount: intersection.size,
+            });
+            userTotalScores[u1.user].sumScore += compatibilityScore;
+            userTotalScores[u1.user].pairCount += 1;
+            userTotalScores[u2.user].sumScore += compatibilityScore;
+            userTotalScores[u2.user].pairCount += 1;
+        }
+    }
+    // Overall group average compatibility
+    const totalPairs = pairwiseMatrix.length;
+    const groupAvgCompat = totalPairs > 0
+        ? Math.round((pairwiseMatrix.reduce((acc, p) => acc + p.compatibilityScore, 0) / totalPairs) * 100) / 100
+        : 0;
+    // Determine Outlier (lowest avg compatibility) and Anchor (highest avg compatibility)
+    let minAvg = Number.POSITIVE_INFINITY;
+    let maxAvg = Number.NEGATIVE_INFINITY;
+    let groupOutlier = null;
+    let groupAnchor = null;
+    for (const [u, data] of Object.entries(userTotalScores)) {
+        if (data.pairCount > 0) {
+            const avg = Math.round((data.sumScore / data.pairCount) * 100) / 100;
+            if (avg < minAvg) {
+                minAvg = avg;
+                groupOutlier = { user: u, averageCompatibility: avg };
+            }
+            if (avg > maxAvg) {
+                maxAvg = avg;
+                groupAnchor = { user: u, averageCompatibility: avg };
+            }
+        }
+    }
+    // Consensus artists: aggregated across all users
+    const artistAgg = new Map();
+    for (const { user, artistMap } of userArtistRosters) {
+        for (const [key, data] of artistMap.entries()) {
+            const existing = artistAgg.get(key);
+            if (existing) {
+                existing.listeners.add(user);
+                existing.totalPlays += data.playcount;
+            }
+            else {
+                artistAgg.set(key, {
+                    name: data.name,
+                    listeners: new Set([user]),
+                    totalPlays: data.playcount,
+                });
+            }
+        }
+    }
+    // Filter artists heard by at least 2 users (or >= 50% of the group)
+    const minListenersRequired = users.length > 2 ? 2 : 1;
+    const consensusArtists = Array.from(artistAgg.values())
+        .filter((a) => a.listeners.size >= minListenersRequired)
+        .map((a) => ({
+        name: a.name,
+        listenerCount: a.listeners.size,
+        listenerPercentage: Math.round((a.listeners.size / users.length) * 10000) / 100,
+        listeners: Array.from(a.listeners),
+        totalPlays: a.totalPlays,
+    }))
+        .sort((a, b) => b.listenerCount - a.listenerCount || b.totalPlays - a.totalPlays)
+        .slice(0, 20);
+    return {
+        users,
+        period,
+        groupAverageCompatibility: groupAvgCompat,
+        groupOutlier,
+        groupAnchor,
+        consensusArtists,
+        pairwiseMatrix,
+    };
+}
+//# sourceMappingURL=group.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsHoursRequest, InsightsHoursResponse } from '../schemas.js';
+/**
+ * Buckets a user's recent scrobbles by hour-of-day (0..23) and weekday (0..6),
+ * calculating diurnal distribution and peak listening times.
+ */
+export declare function getHoursHistogram(config: LastFmConfig, params: InsightsHoursRequest, init?: RequestInit): Promise<InsightsHoursResponse>;
+//# sourceMappingURL=hours.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hours.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/hours.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAEhF;;;GAGG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,qBAAqB,CAAC,CA0ChC"}

package/dist/insights/algorithms/hours.js

@@ -0,0 +1,43 @@
+import { createUserService } from '../../core/services/user.js';
+import { buildHourHistogram } from '../lib/hours.js';
+/**
+ * Buckets a user's recent scrobbles by hour-of-day (0..23) and weekday (0..6),
+ * calculating diurnal distribution and peak listening times.
+ */
+export async function getHoursHistogram(config, params, init) {
+    const userService = createUserService(config);
+    const to = params.to ?? Math.floor(Date.now() / 1000);
+    const from = params.from ?? (params.sinceDays ? to - params.sinceDays * 86400 : to - 30 * 86400);
+    const maxPages = params.maxPages ?? 50;
+    const timestamps = [];
+    let page = 1;
+    while (page <= maxPages) {
+        const res = await userService.getRecentTracks({
+            user: params.user,
+            from: String(from),
+            to: String(to),
+            limit: 200,
+            page,
+        }, init);
+        const tracks = res.recenttracks?.track ?? [];
+        for (const t of tracks) {
+            const uts = t.date?.uts;
+            if (uts) {
+                const num = Number(uts);
+                if (!Number.isNaN(num))
+                    timestamps.push(num);
+            }
+        }
+        if (tracks.length < 200)
+            break;
+        page++;
+    }
+    const histogram = buildHourHistogram(timestamps);
+    return {
+        user: params.user,
+        from,
+        to,
+        ...histogram,
+    };
+}
+//# sourceMappingURL=hours.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hours.js","sourceRoot":"","sources":["../../../src/insights/algorithms/hours.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,MAAoB,EACpB,MAA4B,EAC5B,IAAkB;IAElB,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,CAAA;IAChG,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;IAEtC,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAA;IAEZ,OAAO,IAAI,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,eAAe,CAC5C;YACC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YAClB,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;YACd,KAAK,EAAE,GAAG;YACV,IAAI;SACJ,EACD,IAAI,CACJ,CAAA;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAA;QAC5C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,CAAA;YACvB,IAAI,GAAG,EAAE,CAAC;gBACT,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;gBACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;oBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC7C,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;YAAE,MAAK;QAC9B,IAAI,EAAE,CAAA;IACP,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAEhD,OAAO;QACN,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI;QACJ,EAAE;QACF,GAAG,SAAS;KACZ,CAAA;AACF,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsMoodRequest, InsightsMoodResponse } from '../schemas.js';
+/**
+ * Classifies a user's emotional mood profile (energy vs. valence coordinates,
+ * mood quadrant, and top genre categories) based on user and artist tags.
+ */
+export declare function getMood(config: LastFmConfig, params: InsightsMoodRequest, init?: RequestInit): Promise<InsightsMoodResponse>;
+//# sourceMappingURL=mood.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mood.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/mood.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAKnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAE9E;;;GAGG;AACH,wBAAsB,OAAO,CAC5B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,mBAAmB,EAC3B,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,oBAAoB,CAAC,CA2D/B"}

package/dist/insights/algorithms/mood.js

@@ -0,0 +1,53 @@
+import { createArtistService } from '../../core/services/artist.js';
+import { createUserService } from '../../core/services/user.js';
+import { classifyMood } from '../lib/mood.js';
+import { resolvePeriod } from '../lib/periods.js';
+/**
+ * Classifies a user's emotional mood profile (energy vs. valence coordinates,
+ * mood quadrant, and top genre categories) based on user and artist tags.
+ */
+export async function getMood(config, params, init) {
+    const userService = createUserService(config);
+    const artistService = createArtistService(config);
+    const resolved = resolvePeriod(params.period ?? '7day');
+    const topArtistsLimit = typeof params.topArtistsLimit === 'string'
+        ? Number.parseInt(params.topArtistsLimit, 10)
+        : (params.topArtistsLimit ?? 10);
+    const [topArtistsRes, userTagsRes] = await Promise.all([
+        userService.getTopArtists({ user: params.user, period: resolved.lastfm, limit: topArtistsLimit }, init),
+        userService.getTopTags({ user: params.user, limit: 50 }, init),
+    ]);
+    const artistNames = (topArtistsRes.topartists?.artist ?? [])
+        .map((a) => a.name)
+        .filter((name) => typeof name === 'string' && name.length > 0)
+        .slice(0, topArtistsLimit);
+    const userTags = (userTagsRes.toptags?.tag ?? [])
+        .map((t) => t.name)
+        .filter((name) => typeof name === 'string' && name.length > 0);
+    const perArtist = await Promise.allSettled(artistNames.map((name) => artistService
+        .getTopTags({ artist: name }, init)
+        .then((res) => (res.toptags?.tag ?? []).map((t) => t.name).filter((n) => typeof n === 'string' && n.length > 0))));
+    const artistTags = [];
+    let artistHits = 0;
+    for (const r of perArtist) {
+        if (r.status === 'fulfilled') {
+            artistTags.push(...r.value);
+            artistHits++;
+        }
+    }
+    const allTags = [...userTags, ...artistTags];
+    const profile = classifyMood(allTags);
+    const primarySource = userTags.length === 0 ? 'artist-tags' : artistTags.length === 0 ? 'user-tags' : 'mixed';
+    return {
+        user: params.user,
+        period: resolved.lastfm,
+        axes: profile.axes,
+        label: profile.label,
+        categories: [...profile.categories],
+        confidence: profile.confidence,
+        tagSourceCount: allTags.length,
+        artistCount: artistHits,
+        primarySource,
+    };
+}
+//# sourceMappingURL=mood.js.map

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

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

package/dist/insights/algorithms/now-playing.d.ts

@@ -0,0 +1,20 @@
+import type { LastFmConfig } from '../../config.js';
+import type { InsightsNowPlayingRequest, InsightsNowPlayingResponse } from '../schemas.js';
+/**
+ * Strips Last.fm wiki markup and HTML tags from biography text.
+ */
+export declare function stripWiki(s: string): string;
+/**
+ * Truncates biography text cleanly on a word boundary.
+ */
+export declare function summarizeBio(bio: string | undefined, maxChars: number): string;
+/**
+ * Finds the highest quality image available from a Last.fm image array.
+ */
+export declare function findBestImage(images: unknown): string | undefined;
+/**
+ * Fetches the user's current (or most recent) track and enriches it with
+ * artist biography and similar artists.
+ */
+export declare function getNowPlaying(config: LastFmConfig, params: InsightsNowPlayingRequest, init?: RequestInit): Promise<InsightsNowPlayingResponse>;
+//# sourceMappingURL=now-playing.d.ts.map

package/dist/insights/algorithms/now-playing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now-playing.d.ts","sourceRoot":"","sources":["../../../src/insights/algorithms/now-playing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAE1F;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQjE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,yBAAyB,EACjC,IAAI,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,0BAA0B,CAAC,CAmGrC"}