@ansango/lastfm-api 3.3.0 → 3.5.0

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

@@ -0,0 +1,30 @@
+/**
+ * personality.ts — classify the user into a listening personality archetype.
+ */
+export type ArchetypeId = 'Devotee' | 'Explorer' | 'Drifter' | 'DJ' | 'Nocturnal' | 'Archivist';
+export declare const ARCHETYPE_ORDER: readonly ArchetypeId[];
+export interface PersonalityFeatures {
+    readonly totalScrobbles: number;
+    readonly uniqueArtists: number;
+    readonly top1Share: number;
+    readonly top3Share: number;
+    readonly top5Share: number;
+    readonly normalizedDiversity: number;
+    readonly newArtistsLast30d: number;
+    readonly totalArtistsLast30d: number;
+    readonly nightHourShare: number;
+    readonly morningHourShare: number;
+    readonly weekdayShare: number;
+}
+export interface PersonalityResult {
+    readonly scores: Record<ArchetypeId, number>;
+    readonly winner: ArchetypeId;
+    readonly reasons: readonly string[];
+}
+export declare const ARCHETYPE_INFO: Record<ArchetypeId, {
+    name: string;
+    emoji: string;
+    blurb: string;
+}>;
+export declare function scoreArchetypes(features: PersonalityFeatures): PersonalityResult;
+//# sourceMappingURL=personality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personality.d.ts","sourceRoot":"","sources":["../../../src/insights/lib/personality.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,GAAG,WAAW,CAAA;AAE/F,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAOjD,CAAA;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC;AAMD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+B9F,CAAA;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,mBAAmB,GAAG,iBAAiB,CA2FhF"}

package/dist/insights/lib/personality.js

@@ -0,0 +1,131 @@
+/**
+ * personality.ts — classify the user into a listening personality archetype.
+ */
+export const ARCHETYPE_ORDER = [
+    'Devotee',
+    'Explorer',
+    'Drifter',
+    'DJ',
+    'Nocturnal',
+    'Archivist',
+];
+function clamp01(n) {
+    return Math.max(0, Math.min(1, n));
+}
+export const ARCHETYPE_INFO = {
+    Devotee: {
+        name: 'The Devotee',
+        emoji: '🛐',
+        blurb: 'Extreme loyalty to your favorite artists. High concentration, low dispersion.',
+    },
+    Explorer: {
+        name: 'The Explorer',
+        emoji: '🧭',
+        blurb: 'Always discovering new music. Your musical radar is constantly searching.',
+    },
+    Drifter: {
+        name: 'The Drifter',
+        emoji: '🍂',
+        blurb: 'Balanced listening across varied genres without strong fixations.',
+    },
+    DJ: {
+        name: 'The DJ',
+        emoji: '🎧',
+        blurb: 'High listening velocity across a broad and rotating selection of artists.',
+    },
+    Nocturnal: {
+        name: 'The Nocturnal',
+        emoji: '🌙',
+        blurb: 'Your music comes alive at night. The late hours are your peak listening zone.',
+    },
+    Archivist: {
+        name: 'The Archivist',
+        emoji: '📚',
+        blurb: 'A massive, eclectic, and deep personal music library with balanced play counts.',
+    },
+};
+export function scoreArchetypes(features) {
+    const scores = {
+        Devotee: 0,
+        Explorer: 0,
+        Drifter: 0,
+        DJ: 0,
+        Nocturnal: 0,
+        Archivist: 0,
+    };
+    const reasons = {
+        Devotee: [],
+        Explorer: [],
+        Drifter: [],
+        DJ: [],
+        Nocturnal: [],
+        Archivist: [],
+    };
+    // Devotee: high top1Share + low diversity + small unique roster
+    {
+        const focus = clamp01((features.top1Share - 0.15) / 0.5);
+        const monotony = clamp01((0.6 - features.normalizedDiversity) / 0.6);
+        const smallness = clamp01((20 - features.uniqueArtists) / 20);
+        scores.Devotee = Math.round((0.5 * focus + 0.3 * monotony + 0.2 * smallness) * 100) / 100;
+        if (focus > 0.5)
+            reasons.Devotee.push(`Top artist accounts for ${(features.top1Share * 100).toFixed(0)}% of scrobbles.`);
+        if (monotony > 0.5)
+            reasons.Devotee.push(`Low diversity score (${features.normalizedDiversity.toFixed(2)}).`);
+    }
+    // Explorer: high diversity + many new artists relative to total roster
+    {
+        const diversity = features.normalizedDiversity;
+        const newRatio = features.totalArtistsLast30d > 0 ? clamp01(features.newArtistsLast30d / features.totalArtistsLast30d) : 0;
+        scores.Explorer = Math.round((0.5 * diversity + 0.5 * newRatio) * 100) / 100;
+        if (diversity > 0.7)
+            reasons.Explorer.push(`High diversity score (${diversity.toFixed(2)}).`);
+        if (newRatio > 0.2)
+            reasons.Explorer.push(`${features.newArtistsLast30d} new artists discovered this month out of ${features.totalArtistsLast30d} played.`);
+    }
+    // Drifter: middle of the road on diversity and low novelty
+    {
+        const midDiversity = 1 - Math.abs(features.normalizedDiversity - 0.65) / 0.35;
+        const lowNovelty = clamp01((0.15 - (features.totalArtistsLast30d > 0 ? features.newArtistsLast30d / features.totalArtistsLast30d : 0)) /
+            0.15);
+        const lowFocus = clamp01((0.4 - features.top3Share) / 0.4);
+        scores.Drifter = Math.round((0.4 * midDiversity + 0.3 * lowNovelty + 0.3 * lowFocus) * 100) / 100;
+        if (midDiversity > 0.7)
+            reasons.Drifter.push(`Moderate diversity (${features.normalizedDiversity.toFixed(2)}).`);
+    }
+    // DJ: high velocity + many artists
+    {
+        const velocity = clamp01((features.totalScrobbles - 200) / 1800);
+        const breadth = clamp01((features.uniqueArtists - 20) / 80);
+        scores.DJ = Math.round((0.5 * velocity + 0.3 * breadth + 0.2 * features.normalizedDiversity) * 100) / 100;
+        if (velocity > 0.5)
+            reasons.DJ.push(`${features.totalScrobbles} total scrobbles in the window.`);
+    }
+    // Nocturnal: nightHourShare dominant
+    {
+        const nightness = clamp01((features.nightHourShare - 0.4) / 0.2);
+        const antiDaytime = clamp01((0.3 - features.morningHourShare) / 0.3);
+        scores.Nocturnal = Math.round((0.7 * nightness + 0.3 * antiDaytime) * 100) / 100;
+        if (nightness > 0.5)
+            reasons.Nocturnal.push(`${(features.nightHourShare * 100).toFixed(0)}% of scrobbles occurred during night hours.`);
+    }
+    // Archivist: massive library, spread across many artists
+    {
+        const massive = clamp01((features.totalScrobbles - 1500) / 3500);
+        const hugeRoster = clamp01((features.uniqueArtists - 100) / 200);
+        const spread = clamp01((1 - features.top5Share) / 0.5);
+        scores.Archivist = Math.round((0.4 * massive + 0.4 * hugeRoster + 0.2 * spread) * 100) / 100;
+        if (hugeRoster > 0.5)
+            reasons.Archivist.push(`${features.uniqueArtists} unique artists in window.`);
+    }
+    let winner = 'Devotee';
+    let best = -Number.POSITIVE_INFINITY;
+    for (const id of ARCHETYPE_ORDER) {
+        const s = scores[id];
+        if (s > best) {
+            best = s;
+            winner = id;
+        }
+    }
+    return { scores, winner, reasons: reasons[winner] ?? [] };
+}
+//# sourceMappingURL=personality.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * trends.ts — diff two ranked lists to calculate rank & count movements.
+ *
+ * Partitions items into 4 buckets:
+ * - risers: climbed in rank (positive deltaRank) or increased plays
+ * - fallers: dropped in rank (negative deltaRank) or decreased plays
+ * - newcomers: present in current period but absent in previous
+ * - departures: present in previous period but absent in current
+ */
+export interface RankedItem {
+    readonly name: string;
+    readonly playcount: number;
+}
+export interface RankedItemWithDelta extends RankedItem {
+    readonly currentRank: number;
+    readonly previousRank?: number;
+    readonly deltaRank: number;
+    readonly deltaCount: number;
+}
+export interface DiffRankingsOptions {
+    readonly maxResults?: number;
+}
+export interface RankingDiffResult {
+    readonly risers: RankedItemWithDelta[];
+    readonly fallers: RankedItemWithDelta[];
+    readonly newcomers: RankedItemWithDelta[];
+    readonly departures: RankedItem[];
+}
+export declare function diffRankings(current: readonly RankedItem[], previous: readonly RankedItem[], options?: DiffRankingsOptions): RankingDiffResult;
+//# sourceMappingURL=trends.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trends.d.ts","sourceRoot":"","sources":["../../../src/insights/lib/trends.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,EAAE,CAAA;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,CAAA;CACjC;AAUD,wBAAgB,YAAY,CAC3B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,OAAO,GAAE,mBAAwB,GAC/B,iBAAiB,CA8DnB"}

package/dist/insights/lib/trends.js

@@ -0,0 +1,67 @@
+function indexByName(list) {
+    const m = new Map();
+    list.forEach((item, idx) => {
+        m.set(item.name, { idx, item });
+    });
+    return m;
+}
+export function diffRankings(current, previous, options = {}) {
+    const curIdx = indexByName(current);
+    const prevIdx = indexByName(previous);
+    const risers = [];
+    const fallers = [];
+    const newcomers = [];
+    current.forEach((cur, i) => {
+        const prev = prevIdx.get(cur.name);
+        if (!prev) {
+            newcomers.push({
+                name: cur.name,
+                playcount: cur.playcount,
+                currentRank: i + 1,
+                deltaRank: 0,
+                deltaCount: cur.playcount,
+            });
+            return;
+        }
+        const deltaRank = prev.idx - i; // positive = climbed in rank
+        const deltaCount = cur.playcount - prev.item.playcount;
+        if (deltaRank > 0 || deltaCount > 0) {
+            risers.push({
+                name: cur.name,
+                playcount: cur.playcount,
+                currentRank: i + 1,
+                previousRank: prev.idx + 1,
+                deltaRank,
+                deltaCount,
+            });
+        }
+        else if (deltaRank < 0 || deltaCount < 0) {
+            fallers.push({
+                name: cur.name,
+                playcount: cur.playcount,
+                currentRank: i + 1,
+                previousRank: prev.idx + 1,
+                deltaRank,
+                deltaCount,
+            });
+        }
+    });
+    const departures = [];
+    previous.forEach((prev) => {
+        if (!curIdx.has(prev.name)) {
+            departures.push(prev);
+        }
+    });
+    // Sort buckets by current rank ascending
+    risers.sort((a, b) => a.currentRank - b.currentRank);
+    fallers.sort((a, b) => a.currentRank - b.currentRank);
+    newcomers.sort((a, b) => a.currentRank - b.currentRank);
+    const max = options.maxResults ?? Number.POSITIVE_INFINITY;
+    return {
+        risers: risers.slice(0, max),
+        fallers: fallers.slice(0, max),
+        newcomers: newcomers.slice(0, max),
+        departures: departures.slice(0, max),
+    };
+}
+//# sourceMappingURL=trends.js.map

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

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