@ansango/lastfm-api 3.3.0 → 3.4.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"binges.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/binges.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE/C,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,SAAS,EAAE,CAyD3G"}

package/dist/services/insights/lib/binges.js

@@ -0,0 +1,61 @@
+function keyOf(s, k) {
+    return k === 'artist' ? s.artist : `${s.artist}::${s.track}`;
+}
+/**
+ * Finds consecutive listening runs in a chronologically ordered array of scrobbles.
+ */
+export function findBinges(scrobbles, options = {}) {
+    const minLength = options.minLength ?? 2;
+    const maxGap = options.maxGapSeconds ?? 3600;
+    const trackKey = options.trackKey ?? 'artist';
+    const out = [];
+    let runKey = null;
+    let runArtist = null;
+    let runTrack = null;
+    let runStart = 0;
+    let runEnd = 0;
+    let runLen = 0;
+    const flush = () => {
+        if (runLen >= minLength && runKey !== null && runArtist !== null) {
+            out.push({
+                artist: runArtist,
+                ...(trackKey === 'track' && runTrack !== null ? { track: runTrack } : {}),
+                length: runLen,
+                startUts: runStart,
+                endUts: runEnd,
+                durationSeconds: runEnd - runStart,
+            });
+        }
+        runKey = null;
+        runLen = 0;
+    };
+    for (const s of scrobbles) {
+        const k = keyOf(s, trackKey);
+        if (runKey === null) {
+            runKey = k;
+            runArtist = s.artist;
+            runTrack = s.track;
+            runStart = s.uts;
+            runEnd = s.uts;
+            runLen = 1;
+            continue;
+        }
+        if (k !== runKey || s.uts - runEnd > maxGap) {
+            flush();
+            runKey = k;
+            runArtist = s.artist;
+            runTrack = s.track;
+            runStart = s.uts;
+            runEnd = s.uts;
+            runLen = 1;
+            continue;
+        }
+        runEnd = s.uts;
+        runLen++;
+    }
+    flush();
+    // Sort primarily by run length descending, secondarily by most recent
+    out.sort((a, b) => b.length - a.length || b.endUts - a.endUts);
+    return options.maxResults !== undefined ? out.slice(0, options.maxResults) : out;
+}
+//# sourceMappingURL=binges.js.map

package/dist/services/insights/lib/binges.js.map

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

package/dist/services/insights/lib/compare.d.ts

@@ -0,0 +1,31 @@
+/**
+ * compare.ts — compare two ranked artist lists and compute Jaccard similarity.
+ */
+export interface NamedArtistEntry {
+    readonly name: string;
+    readonly playcount: number;
+}
+export interface CompareArtistsResult {
+    readonly aCount: number;
+    readonly bCount: number;
+    readonly intersection: readonly string[];
+    readonly sharedArtists: ReadonlyArray<{
+        readonly name: string;
+        readonly userAPlaycount: number;
+        readonly userBPlaycount: number;
+        readonly weight: number;
+    }>;
+    readonly onlyA: readonly string[];
+    readonly onlyB: readonly string[];
+    readonly jaccard: number;
+    readonly compatibilityScore: number;
+}
+/**
+ * Computes Jaccard similarity: |A ∩ B| / |A ∪ B|.
+ */
+export declare function jaccard<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): number;
+/**
+ * Compares two artist rosters, calculating mutual artist overlap and affinity metrics.
+ */
+export declare function compareArtists(a: readonly NamedArtistEntry[], b: readonly NamedArtistEntry[]): CompareArtistsResult;
+//# sourceMappingURL=compare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/compare.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;QAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;QAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KACvB,CAAC,CAAA;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACnC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CASvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,gBAAgB,EAAE,EAAE,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,oBAAoB,CA+CnH"}

package/dist/services/insights/lib/compare.js

@@ -0,0 +1,68 @@
+/**
+ * Computes Jaccard similarity: |A ∩ B| / |A ∪ B|.
+ */
+export function jaccard(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 0;
+    let inter = 0;
+    for (const x of a) {
+        if (b.has(x))
+            inter++;
+    }
+    const union = a.size + b.size - inter;
+    if (union === 0)
+        return 0;
+    return inter / union;
+}
+/**
+ * Compares two artist rosters, calculating mutual artist overlap and affinity metrics.
+ */
+export function compareArtists(a, b) {
+    const mapA = new Map();
+    const mapB = new Map();
+    for (const x of a)
+        mapA.set(x.name, x.playcount);
+    for (const x of b)
+        mapB.set(x.name, x.playcount);
+    const intersection = [];
+    const onlyA = [];
+    const onlyB = [];
+    for (const [name] of mapA) {
+        if (mapB.has(name))
+            intersection.push(name);
+        else
+            onlyA.push(name);
+    }
+    for (const [name] of mapB) {
+        if (!mapA.has(name))
+            onlyB.push(name);
+    }
+    const sharedArtists = intersection
+        .map((name) => {
+        const userAPlaycount = mapA.get(name) ?? 0;
+        const userBPlaycount = mapB.get(name) ?? 0;
+        const weight = Math.min(userAPlaycount, userBPlaycount);
+        return {
+            name,
+            userAPlaycount,
+            userBPlaycount,
+            weight,
+        };
+    })
+        .sort((x, y) => y.weight - x.weight);
+    const setA = new Set(mapA.keys());
+    const setB = new Set(mapB.keys());
+    const j = jaccard(setA, setB);
+    const compatibilityScore = Math.round(j * 100);
+    return {
+        aCount: a.length,
+        bCount: b.length,
+        intersection: intersection.sort(),
+        sharedArtists,
+        onlyA: onlyA.sort(),
+        onlyB: onlyB.sort(),
+        jaccard: Math.round(j * 1000) / 1000,
+        compatibilityScore,
+    };
+}
+//# sourceMappingURL=compare.js.map

package/dist/services/insights/lib/compare.js.map

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

package/dist/services/insights/lib/discoveries.d.ts

@@ -0,0 +1,17 @@
+/**
+ * discoveries.ts — detect newly discovered artists inside a time window
+ * relative to an overall baseline roster.
+ */
+export interface ArtistTimestampItem {
+    readonly name: string;
+    /** UNIX seconds; the earliest occurrence of this artist in the window. */
+    readonly firstSeen: number;
+}
+export interface FindNewArtistsOptions {
+    readonly maxResults?: number;
+}
+/**
+ * Filters and sorts artists first scrobbled in the window that do not exist in the baseline set.
+ */
+export declare function findNewArtists(window: readonly ArtistTimestampItem[], baseline: ReadonlySet<string>, options?: FindNewArtistsOptions): ArtistTimestampItem[];
+//# sourceMappingURL=discoveries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discoveries.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/discoveries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,MAAM,EAAE,SAAS,mBAAmB,EAAE,EACtC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,OAAO,GAAE,qBAA0B,GACjC,mBAAmB,EAAE,CAqBvB"}

package/dist/services/insights/lib/discoveries.js

@@ -0,0 +1,24 @@
+/**
+ * Filters and sorts artists first scrobbled in the window that do not exist in the baseline set.
+ */
+export function findNewArtists(window, baseline, options = {}) {
+    // Dedupe by name; keep earliest firstSeen
+    const earliest = new Map();
+    for (const a of window) {
+        const prev = earliest.get(a.name);
+        if (prev === undefined || a.firstSeen < prev) {
+            earliest.set(a.name, a.firstSeen);
+        }
+    }
+    const newbies = [];
+    for (const [name, firstSeen] of earliest) {
+        if (!baseline.has(name)) {
+            newbies.push({ name, firstSeen });
+        }
+    }
+    // Sort chronologically by first seen
+    newbies.sort((a, b) => a.firstSeen - b.firstSeen);
+    const max = options.maxResults ?? newbies.length;
+    return newbies.slice(0, max);
+}
+//# sourceMappingURL=discoveries.js.map

package/dist/services/insights/lib/discoveries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoveries.js","sourceRoot":"","sources":["../../../../src/services/insights/lib/discoveries.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,UAAU,cAAc,CAC7B,MAAsC,EACtC,QAA6B,EAC7B,UAAiC,EAAE;IAEnC,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,EAAE,CAAC;YAC9C,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,MAAM,OAAO,GAA0B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QAClC,CAAC;IACF,CAAC;IAED,qCAAqC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAA;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAA;IAChD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC7B,CAAC"}

package/dist/services/insights/lib/diversity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * diversity.ts — Shannon entropy + top-N concentration over a count map.
+ *
+ * Pure: takes a {name: count} map and returns normalized metrics.
+ *
+ * Shannon entropy H = -Σ pᵢ ln(pᵢ) where pᵢ = countᵢ / total.
+ * Normalized H / ln(uniqueCount) puts it on [0, 1].
+ */
+export type CountMap = Readonly<Record<string, number>>;
+export interface Diversity {
+    readonly total: number;
+    readonly uniqueCount: number;
+    /** Raw Shannon entropy in nats. */
+    readonly shannon: number;
+    /** Shannon normalized to [0, 1] by dividing by ln(uniqueCount). 1 = perfectly even. */
+    readonly normalized: number;
+}
+/**
+ * Computes the Shannon diversity index over a map of item counts.
+ */
+export declare function computeDiversity(counts: CountMap): Diversity;
+/**
+ * Fraction of total plays consumed by the top-N entries.
+ * - N larger than uniqueCount returns 1.
+ * - Empty map returns 0.
+ */
+export declare function topNShare(counts: CountMap, n: number): number;
+//# sourceMappingURL=diversity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diversity.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/diversity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAEvD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,uFAAuF;IACvF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAiB5D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7D"}

package/dist/services/insights/lib/diversity.js

@@ -0,0 +1,39 @@
+/**
+ * Computes the Shannon diversity index over a map of item counts.
+ */
+export function computeDiversity(counts) {
+    const entries = Object.entries(counts).filter(([, c]) => c > 0);
+    const total = entries.reduce((acc, [, c]) => acc + c, 0);
+    const uniqueCount = entries.length;
+    if (total === 0 || uniqueCount === 0) {
+        return { total: 0, uniqueCount: 0, shannon: 0, normalized: 0 };
+    }
+    if (uniqueCount === 1) {
+        return { total, uniqueCount: 1, shannon: 0, normalized: 0 };
+    }
+    let h = 0;
+    for (const [, c] of entries) {
+        const p = c / total;
+        h -= p * Math.log(p);
+    }
+    const normalized = h / Math.log(uniqueCount);
+    return { total, uniqueCount, shannon: h, normalized };
+}
+/**
+ * Fraction of total plays consumed by the top-N entries.
+ * - N larger than uniqueCount returns 1.
+ * - Empty map returns 0.
+ */
+export function topNShare(counts, n) {
+    const sorted = Object.values(counts)
+        .filter((c) => c > 0)
+        .sort((a, b) => b - a);
+    if (sorted.length === 0)
+        return 0;
+    const total = sorted.reduce((acc, c) => acc + c, 0);
+    if (total === 0)
+        return 0;
+    const top = sorted.slice(0, Math.max(0, n)).reduce((acc, c) => acc + c, 0);
+    return top / total;
+}
+//# sourceMappingURL=diversity.js.map

package/dist/services/insights/lib/diversity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diversity.js","sourceRoot":"","sources":["../../../../src/services/insights/lib/diversity.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACxD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAA;IAClC,IAAI,KAAK,KAAK,CAAC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;IAC/D,CAAC;IACD,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;IAC5D,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACnB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACrB,CAAC;IACD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAC5C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAA;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB,EAAE,CAAS;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;SACpB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IACvB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACnD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IACzB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1E,OAAO,GAAG,GAAG,KAAK,CAAA;AACnB,CAAC"}

package/dist/services/insights/lib/hours.d.ts

@@ -0,0 +1,39 @@
+/**
+ * hours.ts — bucket timestamps by hour-of-day (0..23) and weekday (0..6).
+ *
+ * Weekday indexing follows ISO convention: Mon=0 .. Sun=6.
+ * All bucketing is in UTC for deterministic behavior.
+ */
+export declare const WEEKDAY_LABELS_EN: readonly ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
+export declare const WEEKDAY_LABELS_ES: readonly ["lunes", "martes", "miércoles", "jueves", "viernes", "sábado", "domingo"];
+export interface HourBucket {
+    /** Hour of the day in 24h format, 0–23 (UTC). */
+    readonly hour: number;
+    /** Day of the week, 0 = Monday … 6 = Sunday. */
+    readonly weekday: number;
+}
+/**
+ * Convert a UNIX-seconds timestamp to (hour, weekday).
+ */
+export declare function bucketTimestamp(unixSeconds: number): HourBucket;
+export interface HourHistogram {
+    readonly total: number;
+    /** Counts per hour, index = hour (0..23). Length always 24. */
+    readonly byHour: number[];
+    /** Counts per weekday, index = Mon(0)..Sun(6). Length always 7. */
+    readonly byWeekday: number[];
+    /** Hour with the highest count, or null when total === 0. */
+    readonly peakHour: number | null;
+    readonly peakHourCount: number;
+    readonly peakWeekday: number | null;
+    readonly peakWeekdayCount: number;
+    readonly peakWeekdayLabel: string | null;
+    /** Time-of-day shares [0..1] */
+    readonly nightShare: number;
+    readonly morningShare: number;
+    readonly afternoonShare: number;
+    readonly eveningShare: number;
+    readonly weekendShare: number;
+}
+export declare function buildHourHistogram(timestamps: readonly number[]): HourHistogram;
+//# sourceMappingURL=hours.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hours.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/hours.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,4DAA6D,CAAA;AAC3F,eAAO,MAAM,iBAAiB,qFAAsF,CAAA;AAEpH,MAAM,WAAW,UAAU;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAO/D;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAA;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC7B;AAgBD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,CAmC/E"}

package/dist/services/insights/lib/hours.js

@@ -0,0 +1,66 @@
+/**
+ * hours.ts — bucket timestamps by hour-of-day (0..23) and weekday (0..6).
+ *
+ * Weekday indexing follows ISO convention: Mon=0 .. Sun=6.
+ * All bucketing is in UTC for deterministic behavior.
+ */
+export const WEEKDAY_LABELS_EN = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'];
+export const WEEKDAY_LABELS_ES = ['lunes', 'martes', 'miércoles', 'jueves', 'viernes', 'sábado', 'domingo'];
+/**
+ * Convert a UNIX-seconds timestamp to (hour, weekday).
+ */
+export function bucketTimestamp(unixSeconds) {
+    const date = new Date(unixSeconds * 1000);
+    const hour = date.getUTCHours();
+    // Map JS getUTCDay() (Sun=0..Sat=6) to Mon=0..Sun=6.
+    const jsDow = date.getUTCDay();
+    const weekday = (jsDow + 6) % 7;
+    return { hour, weekday };
+}
+function indexOfMax(arr) {
+    if (arr.length === 0)
+        return null;
+    let maxIdx = 0;
+    let maxVal = arr[0] ?? 0;
+    for (let i = 1; i < arr.length; i++) {
+        const val = arr[i] ?? 0;
+        if (val > maxVal) {
+            maxVal = val;
+            maxIdx = i;
+        }
+    }
+    return maxVal > 0 ? maxIdx : null;
+}
+export function buildHourHistogram(timestamps) {
+    const byHour = new Array(24).fill(0);
+    const byWeekday = new Array(7).fill(0);
+    for (const ts of timestamps) {
+        const b = bucketTimestamp(ts);
+        byHour[b.hour] = (byHour[b.hour] ?? 0) + 1;
+        byWeekday[b.weekday] = (byWeekday[b.weekday] ?? 0) + 1;
+    }
+    const total = timestamps.length;
+    const peakHourIdx = indexOfMax(byHour);
+    const peakWeekdayIdx = indexOfMax(byWeekday);
+    const nightCount = byHour.slice(0, 6).reduce((a, b) => a + b, 0);
+    const morningCount = byHour.slice(6, 12).reduce((a, b) => a + b, 0);
+    const afternoonCount = byHour.slice(12, 18).reduce((a, b) => a + b, 0);
+    const eveningCount = byHour.slice(18, 24).reduce((a, b) => a + b, 0);
+    const weekendCount = (byWeekday[5] ?? 0) + (byWeekday[6] ?? 0);
+    return {
+        total,
+        byHour,
+        byWeekday,
+        peakHour: peakHourIdx,
+        peakHourCount: peakHourIdx !== null ? (byHour[peakHourIdx] ?? 0) : 0,
+        peakWeekday: peakWeekdayIdx,
+        peakWeekdayCount: peakWeekdayIdx !== null ? (byWeekday[peakWeekdayIdx] ?? 0) : 0,
+        peakWeekdayLabel: peakWeekdayIdx !== null ? (WEEKDAY_LABELS_EN[peakWeekdayIdx] ?? null) : null,
+        nightShare: total > 0 ? nightCount / total : 0,
+        morningShare: total > 0 ? morningCount / total : 0,
+        afternoonShare: total > 0 ? afternoonCount / total : 0,
+        eveningShare: total > 0 ? eveningCount / total : 0,
+        weekendShare: total > 0 ? weekendCount / total : 0,
+    };
+}
+//# sourceMappingURL=hours.js.map

package/dist/services/insights/lib/hours.js.map

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

package/dist/services/insights/lib/mood.d.ts

@@ -0,0 +1,22 @@
+/**
+ * mood.ts — derive a 2D mood profile from Last.fm tags.
+ *
+ * Axes:
+ *   energy   ∈ [-1, +1]   -1 = ambient/sleep, +1 = hardcore/thrash
+ *   valence  ∈ [-1, +1]   -1 = doom/sad,      +1 = euphoric/uplifting
+ */
+export interface MoodAxes {
+    readonly energy: number;
+    readonly valence: number;
+}
+export interface MoodProfile {
+    readonly axes: MoodAxes;
+    readonly label: string;
+    readonly categories: readonly string[];
+    readonly confidence: number;
+}
+export declare function axesFromTags(tags: readonly string[]): MoodAxes;
+export declare function categoriesFromTags(tags: readonly string[]): readonly string[];
+export declare function labelFromAxes({ energy, valence }: MoodAxes): string;
+export declare function classifyMood(tags: readonly string[]): MoodProfile;
+//# sourceMappingURL=mood.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mood.d.ts","sourceRoot":"","sources":["../../../../src/services/insights/lib/mood.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuHH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC3B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,CAU9D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAY7E;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,GAAG,MAAM,CAiBnE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAoBjE"}

package/dist/services/insights/lib/mood.js

@@ -0,0 +1,187 @@
+/**
+ * mood.ts — derive a 2D mood profile from Last.fm tags.
+ *
+ * Axes:
+ *   energy   ∈ [-1, +1]   -1 = ambient/sleep, +1 = hardcore/thrash
+ *   valence  ∈ [-1, +1]   -1 = doom/sad,      +1 = euphoric/uplifting
+ */
+const ENERGY = {
+    // high energy
+    hardcore: 1,
+    punk: 0.8,
+    'punk rock': 0.8,
+    'hard rock': 0.7,
+    'thrash metal': 1,
+    'speed metal': 1,
+    grindcore: 1,
+    drum: 0.7,
+    'drum and bass': 0.8,
+    dnb: 0.8,
+    techno: 0.6,
+    gabber: 1,
+    'happy hardcore': 1,
+    rave: 0.9,
+    thrash: 0.9,
+    metal: 0.6,
+    'heavy metal': 0.7,
+    'death metal': 0.8,
+    'black metal': 0.6,
+    rock: 0.5,
+    'indie rock': 0.4,
+    pop: 0.3,
+    dance: 0.6,
+    hip: 0.5,
+    rap: 0.4,
+    hiphop: 0.5,
+    // low energy
+    ambient: -1,
+    drone: -0.9,
+    sleep: -1,
+    'new age': -0.8,
+    meditation: -0.9,
+    downtempo: -0.6,
+    chillout: -0.6,
+    chill: -0.6,
+    lounge: -0.5,
+    'trip-hop': -0.4,
+    'slow core': -0.5,
+    slowcore: -0.5,
+    ballad: -0.4,
+    jazz: -0.2,
+    'smooth jazz': -0.4,
+    'bossa nova': -0.3,
+};
+const VALENCE = {
+    // high valence (euphoric / happy)
+    euphoric: 1,
+    happy: 1,
+    uplifting: 0.9,
+    summer: 0.5,
+    sunshine: 0.6,
+    'feel good': 0.8,
+    feelgood: 0.8,
+    dance: 0.6,
+    party: 0.7,
+    pop: 0.4,
+    'power pop': 0.6,
+    'bubblegum pop': 0.5,
+    'k-pop': 0.4,
+    // low valence (sad / dark)
+    doom: -1,
+    sad: -1,
+    melancholic: -0.9,
+    melancholy: -0.9,
+    depressive: -1,
+    black: -0.7,
+    'black metal': -0.7,
+    'dark ambient': -0.8,
+    dark: -0.6,
+    funeral: -1,
+    'funeral doom': -1,
+    'doom metal': -0.9,
+    goth: -0.7,
+    gothic: -0.7,
+    'gothic rock': -0.6,
+    'post-punk': -0.4,
+    coldwave: -0.6,
+    // neutral-ish
+    indie: 0,
+    'indie rock': 0,
+    rock: 0,
+    electronic: 0,
+    experimental: 0,
+};
+const CATEGORIES = {
+    rock: ['rock', 'indie rock', 'post-rock', 'garage rock', 'hard rock'],
+    electronic: ['electronic', 'techno', 'house', 'ambient', 'idm', 'dnb', 'drum and bass', 'dubstep', 'synth'],
+    'hip-hop': ['hip-hop', 'hip hop', 'rap', 'trap'],
+    jazz: ['jazz', 'bebop', 'bossa nova', 'smooth jazz', 'nu jazz', 'free jazz'],
+    folk: ['folk', 'singer-songwriter', 'acoustic', 'indie folk', 'folk rock'],
+    classical: ['classical', 'baroque', 'romantic', 'modern classical', 'opera', 'symphony'],
+    ambient: ['ambient', 'drone', 'new age', 'meditation', 'dark ambient'],
+    experimental: ['experimental', 'noise', 'avant-garde', 'free improvisation'],
+    metal: ['metal', 'thrash metal', 'doom metal', 'death metal', 'black metal', 'heavy metal', 'sludge'],
+    pop: ['pop', 'synth-pop', 'electropop', 'k-pop', 'indie pop', 'dream pop'],
+    world: ['world', 'afrobeat', 'latin', 'flamenco', 'brazilian', 'reggae'],
+    punk: ['punk', 'post-punk', 'hardcore', 'anarcho-punk'],
+    country: ['country', 'bluegrass', 'outlaw country', 'country rock'],
+    soul: ['soul', 'r&b', 'funk', 'motown', 'neo-soul'],
+};
+function normalize(tag) {
+    return tag.toLowerCase().trim();
+}
+function lookup(map, tag) {
+    return map[tag] ?? 0;
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+export function axesFromTags(tags) {
+    if (tags.length === 0)
+        return { energy: 0, valence: 0 };
+    let energy = 0;
+    let valence = 0;
+    for (const t of tags) {
+        energy += lookup(ENERGY, normalize(t));
+        valence += lookup(VALENCE, normalize(t));
+    }
+    const avg = (n) => Math.max(-1, Math.min(1, n / tags.length));
+    return { energy: round2(avg(energy)), valence: round2(avg(valence)) };
+}
+export function categoriesFromTags(tags) {
+    if (tags.length === 0)
+        return [];
+    const counts = new Map();
+    for (const tag of tags) {
+        const norm = normalize(tag);
+        for (const [cat, members] of Object.entries(CATEGORIES)) {
+            if (members.includes(norm)) {
+                counts.set(cat, (counts.get(cat) ?? 0) + 1);
+            }
+        }
+    }
+    return [...counts.entries()].sort((a, b) => b[1] - a[1]).map(([cat]) => cat);
+}
+export function labelFromAxes({ energy, valence }) {
+    if (energy === 0 && valence === 0)
+        return 'neutral / undefined';
+    const eHigh = energy > 0.2;
+    const eLow = energy < -0.2;
+    const vHigh = valence > 0.2;
+    const vLow = valence < -0.2;
+    if (eHigh && vHigh)
+        return 'euphoric & energetic';
+    if (eHigh && vLow)
+        return 'intense & dark';
+    if (eLow && vHigh)
+        return 'chill & uplifting';
+    if (eLow && vLow)
+        return 'melancholic & calm';
+    if (eHigh && !vHigh && !vLow)
+        return 'high energy';
+    if (eLow && !vHigh && !vLow)
+        return 'low energy / ambient';
+    if (vHigh && !eHigh && !eLow)
+        return 'positive / bright';
+    if (vLow && !eHigh && !eLow)
+        return 'somber / melancholic';
+    return 'neutral / undefined';
+}
+export function classifyMood(tags) {
+    const axes = axesFromTags(tags);
+    const categories = categoriesFromTags(tags);
+    const recognized = tags.filter((t) => {
+        const norm = normalize(t);
+        return (ENERGY[norm] !== undefined ||
+            VALENCE[norm] !== undefined ||
+            Object.values(CATEGORIES).some((arr) => arr.includes(norm)));
+    }).length;
+    const confidence = tags.length === 0 ? 0 : round2(recognized / tags.length);
+    return {
+        axes,
+        label: labelFromAxes(axes),
+        categories,
+        confidence,
+    };
+}
+//# sourceMappingURL=mood.js.map