@ansango/lastfm-api 3.4.0 → 3.6.0

package/dist/reports/schemas.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+import { artistNameSchema, limitSchema, trackNameSchema, userNameSchema } from '../core/schemas/base/index.js';
+export const reportRankedEntitySchema = z.object({
+    name: z.string(),
+    playcount: z.number().int().nonnegative(),
+    percentage: z.number().nonnegative().optional(),
+});
+export const reportRankedTrackSchema = z.object({
+    name: trackNameSchema,
+    artist: artistNameSchema,
+    playcount: z.number().int().nonnegative(),
+});
+export const reportSeasonProfileSchema = z.object({
+    topArtist: artistNameSchema.nullable(),
+    topTrack: trackNameSchema.nullable(),
+    scrobbles: z.number().int().nonnegative(),
+});
+export const reportsWrappedRequestSchema = z.object({
+    user: userNameSchema,
+    year: z.number().int().min(2002).max(2030).optional(),
+    from: z.number().int().positive().optional(),
+    to: z.number().int().positive().optional(),
+});
+export const reportsWrappedResponseSchema = z.object({
+    user: userNameSchema,
+    year: z.number().int().optional(),
+    from: z.number().int().positive(),
+    to: z.number().int().positive(),
+    totalScrobbles: z.number().int().nonnegative(),
+    estimatedListeningMinutes: z.number().nonnegative(),
+    topArtists: z.array(reportRankedEntitySchema),
+    topTracks: z.array(reportRankedTrackSchema),
+    topAlbums: z.array(reportRankedTrackSchema),
+    busiestDay: z.object({
+        date: z.string(),
+        scrobbles: z.number().int().nonnegative(),
+        topArtist: artistNameSchema.nullable(),
+    }),
+    seasons: z.object({
+        winter: reportSeasonProfileSchema,
+        spring: reportSeasonProfileSchema,
+        summer: reportSeasonProfileSchema,
+        fall: reportSeasonProfileSchema,
+    }),
+});
+export const reportMilestoneItemSchema = z.object({
+    milestone: z.number().int().positive(),
+    track: trackNameSchema,
+    artist: artistNameSchema,
+    timestamp: z.number().int().positive(),
+    date: z.string(),
+});
+export const reportsMilestonesRequestSchema = z.object({
+    user: userNameSchema,
+    targets: z.array(z.number().int().positive()).optional(),
+    sampleLimit: limitSchema.optional(),
+});
+export const reportsMilestonesResponseSchema = z.object({
+    user: userNameSchema,
+    totalScrobbles: z.number().int().nonnegative(),
+    milestones: z.array(reportMilestoneItemSchema),
+    nextMilestone: z.object({
+        target: z.number().int().positive(),
+        remainingScrobbles: z.number().int().nonnegative(),
+        estimatedDaysRemaining: z.number().nonnegative(),
+        projectedDate: z.string(),
+    }),
+});
+export const reportsMonthlyDigestRequestSchema = z.object({
+    user: userNameSchema,
+    year: z.number().int().min(2002).max(2030).optional(),
+    month: z.number().int().min(1).max(12).optional(),
+});
+export const reportsMonthlyDigestResponseSchema = z.object({
+    user: userNameSchema,
+    year: z.number().int(),
+    month: z.number().int(),
+    monthName: z.string(),
+    totalScrobbles: z.number().int().nonnegative(),
+    previousMonthScrobbles: z.number().int().nonnegative(),
+    growthPercentage: z.number(),
+    topArtists: z.array(reportRankedEntitySchema),
+    topTracks: z.array(reportRankedTrackSchema),
+});
+// Schema naming convention aliases for registry lookup
+export const reportsGetWrappedRequestSchema = reportsWrappedRequestSchema;
+export const reportsGetWrappedResponseSchema = reportsWrappedResponseSchema;
+export const reportsGetMilestonesRequestSchema = reportsMilestonesRequestSchema;
+export const reportsGetMilestonesResponseSchema = reportsMilestonesResponseSchema;
+export const reportsGetMonthlyDigestRequestSchema = reportsMonthlyDigestRequestSchema;
+export const reportsGetMonthlyDigestResponseSchema = reportsMonthlyDigestResponseSchema;
+//# sourceMappingURL=schemas.js.map

package/dist/reports/schemas.js.map

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

package/dist/reports/service.d.ts

@@ -0,0 +1,30 @@
+import type { LastFmConfig } from '../config.js';
+import type { ReportsMilestonesRequest, ReportsMilestonesResponse, ReportsMonthlyDigestRequest, ReportsMonthlyDigestResponse, ReportsWrappedRequest, ReportsWrappedResponse } from './schemas.js';
+export interface ReportsService {
+    /**
+     * Generates a comprehensive Year in Review / Wrapped report.
+     *
+     * @param {ReportsWrappedRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<ReportsWrappedResponse>}
+     */
+    getWrapped: (params: ReportsWrappedRequest, init?: RequestInit) => Promise<ReportsWrappedResponse>;
+    /**
+     * Detects historical scrobble milestone achievements and projects the estimated date for the next target.
+     *
+     * @param {ReportsMilestonesRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<ReportsMilestonesResponse>}
+     */
+    getMilestones: (params: ReportsMilestonesRequest, init?: RequestInit) => Promise<ReportsMilestonesResponse>;
+    /**
+     * Generates a monthly digest bulletin comparing listening activity to the previous month.
+     *
+     * @param {ReportsMonthlyDigestRequest} params
+     * @param {RequestInit} [init]
+     * @returns {Promise<ReportsMonthlyDigestResponse>}
+     */
+    getMonthlyDigest: (params: ReportsMonthlyDigestRequest, init?: RequestInit) => Promise<ReportsMonthlyDigestResponse>;
+}
+export declare function createReportsService(config: LastFmConfig): ReportsService;
+//# sourceMappingURL=service.d.ts.map

package/dist/reports/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/reports/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAIhD,OAAO,KAAK,EACX,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,cAAc;IAC9B;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAElG;;;;;;OAMG;IACH,aAAa,EAAE,CAAC,MAAM,EAAE,wBAAwB,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAA;IAE3G;;;;;;OAMG;IACH,gBAAgB,EAAE,CAAC,MAAM,EAAE,2BAA2B,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,4BAA4B,CAAC,CAAA;CACpH;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAMzE"}

package/dist/reports/service.js

@@ -0,0 +1,11 @@
+import { getMonthlyDigest } from './generators/digest.js';
+import { getMilestones } from './generators/milestones.js';
+import { getWrapped } from './generators/wrapped.js';
+export function createReportsService(config) {
+    return {
+        getWrapped: (params, init) => getWrapped(config, params, init),
+        getMilestones: (params, init) => getMilestones(config, params, init),
+        getMonthlyDigest: (params, init) => getMonthlyDigest(config, params, init),
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/reports/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/reports/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAuCpD,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACxD,OAAO;QACN,UAAU,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QAC9D,aAAa,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;QACpE,gBAAgB,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;KAC1E,CAAA;AACF,CAAC"}

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+import type { CacheManager } from './cache/manager.js';
 import type { LastFmConfig } from './config.js';
 /**
  * Error thrown when a Last.fm API call fails. Carries the HTTP status and
@@ -17,9 +18,9 @@ export declare class LastFmApiError extends Error {
  */
 export declare function parseLastFmResponse(response: Response): Promise<unknown>;
 /**
- * Realiza una petición HTTP y parsea la respuesta como JSON
+ * Realiza una petición HTTP y parsea la respuesta como JSON con soporte de caché transparente
  */
-export declare function fetcher<T>(url: string, init?: RequestInit): Promise<T>;
+export declare function fetcher<T>(url: string, init?: RequestInit, cacheManager?: CacheManager): Promise<T>;
 /**
  * Construye la URL para las peticiones a la API de Last.fm
  */

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI/C;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM9D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAuB9E;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAG5E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,MAAM,CAUvG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAW3F;AAiBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,MAAM,CAiB3G;AAkBD,MAAM,WAAW,oBAAoB;IACpC,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;IACnD;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAoFZ"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAa/C;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM9D;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAuB9E;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBzG;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,MAAM,CAUvG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAW3F;AAiBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,MAAM,CAiB3G;AAkBD,MAAM,WAAW,oBAAoB;IACpC,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;IACnD;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAC3C,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAoFZ"}

package/dist/utils.js

@@ -1,5 +1,14 @@
 import { md5 } from 'js-md5';
 const DEFAULT_BASE_URL = 'https://ws.audioscrobbler.com/2.0/';
+function extractMethodFromUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.searchParams.get('method') ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * Error thrown when a Last.fm API call fails. Carries the HTTP status and
  * (when available) the Last.fm-specific error code so callers can branch on
@@ -40,9 +49,17 @@ export async function parseLastFmResponse(response) {
     return body;
 }
 /**
- * Realiza una petición HTTP y parsea la respuesta como JSON
+ * Realiza una petición HTTP y parsea la respuesta como JSON con soporte de caché transparente
  */
-export async function fetcher(url, init) {
+export async function fetcher(url, init, cacheManager) {
+    if (cacheManager?.isEnabled() && (!init?.method || init.method.toUpperCase() === 'GET')) {
+        const method = extractMethodFromUrl(url);
+        const ttl = cacheManager.resolveTtl(method);
+        return cacheManager.wrap(url, async () => {
+            const response = await fetch(url, init);
+            return (await parseLastFmResponse(response));
+        }, ttl);
+    }
     const response = await fetch(url, init);
     return (await parseLastFmResponse(response));
 }

package/dist/utils.js.map

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

package/dist/watcher/emitter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Isomorphic, zero-dependency typed event emitter compatible with Node.js, Bun, and Browsers.
+ */
+export type Listener<T extends unknown[] = unknown[]> = (...args: T) => void;
+export declare class TypedEventEmitter<Events extends Record<string, unknown[]>> {
+    private readonly listeners;
+    on<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    once<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    off<K extends keyof Events>(event: K, listener: (...args: Events[K]) => void): this;
+    emit<K extends keyof Events>(event: K, ...args: Events[K]): boolean;
+    removeAllListeners<K extends keyof Events>(event?: K): this;
+    listenerCount<K extends keyof Events>(event: K): number;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/watcher/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/watcher/emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAE5E,qBAAa,iBAAiB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IAE5D,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAUlF,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAQpF,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAWnF,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO;IA0BnE,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAS3D,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAG9D"}

package/dist/watcher/emitter.js

@@ -0,0 +1,72 @@
+/**
+ * Isomorphic, zero-dependency typed event emitter compatible with Node.js, Bun, and Browsers.
+ */
+export class TypedEventEmitter {
+    listeners = new Map();
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return this;
+    }
+    once(event, listener) {
+        const onceWrapper = ((...args) => {
+            this.off(event, onceWrapper);
+            listener(...args);
+        });
+        return this.on(event, onceWrapper);
+    }
+    off(event, listener) {
+        const set = this.listeners.get(event);
+        if (set) {
+            set.delete(listener);
+            if (set.size === 0) {
+                this.listeners.delete(event);
+            }
+        }
+        return this;
+    }
+    emit(event, ...args) {
+        const set = this.listeners.get(event);
+        if (!set || set.size === 0)
+            return false;
+        for (const listener of Array.from(set)) {
+            try {
+                listener(...args);
+            }
+            catch (err) {
+                // Prevent listener exceptions from breaking the emitter loop
+                if (event !== 'error') {
+                    const errorSet = this.listeners.get('error');
+                    if (errorSet) {
+                        for (const errorListener of Array.from(errorSet)) {
+                            try {
+                                errorListener(err);
+                            }
+                            catch {
+                                // ignore error in error handler
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return true;
+    }
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+        return this;
+    }
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/watcher/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/watcher/emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,iBAAiB;IACZ,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAA;IAE5D,EAAE,CAAyB,KAAQ,EAAE,QAAsC;QACjF,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACV,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;YACf,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC/B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAoB,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAA;IACZ,CAAC;IAEM,IAAI,CAAyB,KAAQ,EAAE,QAAsC;QACnF,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;YAC3C,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;YAC5B,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;QAClB,CAAC,CAAwB,CAAA;QACzB,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,WAA2C,CAAC,CAAA;IACnE,CAAC;IAEM,GAAG,CAAyB,KAAQ,EAAE,QAAsC;QAClF,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,GAAG,EAAE,CAAC;YACT,GAAG,CAAC,MAAM,CAAC,QAAoB,CAAC,CAAA;YAChC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC7B,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAEM,IAAI,CAAyB,KAAQ,EAAE,GAAG,IAAe;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAA;QAExC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC;gBACJ,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,6DAA6D;gBAC7D,IAAI,KAAK,KAAM,OAAwB,EAAE,CAAC;oBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAkC,CAAC,CAAA;oBACvE,IAAI,QAAQ,EAAE,CAAC;wBACd,KAAK,MAAM,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAClD,IAAI,CAAC;gCACJ,aAAa,CAAC,GAAG,CAAC,CAAA;4BACnB,CAAC;4BAAC,MAAM,CAAC;gCACR,gCAAgC;4BACjC,CAAC;wBACF,CAAC;oBACF,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAEM,kBAAkB,CAAyB,KAAS;QAC1D,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;QACD,OAAO,IAAI,CAAA;IACZ,CAAC;IAEM,aAAa,CAAyB,KAAQ;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;IAC5C,CAAC;CACD"}

package/dist/watcher/index.d.ts

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

package/dist/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/watcher/index.js

@@ -0,0 +1,5 @@
+export * from './emitter.js';
+export * from './schemas.js';
+export * from './service.js';
+export * from './watcher.js';
+//# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/watcher/schemas.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export declare const watcherTrackSchema: z.ZodObject<{
+    name: z.ZodString;
+    artist: z.ZodString;
+    album: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        '#text': z.ZodString;
+        size: z.ZodUnion<readonly [z.ZodLiteral<"small">, z.ZodLiteral<"medium">, z.ZodLiteral<"large">, z.ZodLiteral<"extralarge">, z.ZodLiteral<"mega">]>;
+    }, z.core.$strip>>>;
+    mbid: z.ZodOptional<z.ZodString>;
+    nowPlaying: z.ZodBoolean;
+    uts: z.ZodOptional<z.ZodNumber>;
+    scrobbledAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const watcherIdleStatusSchema: z.ZodObject<{
+    user: z.ZodString;
+    lastSeenUts: z.ZodNullable<z.ZodNumber>;
+    idleMinutes: z.ZodNumber;
+    checkedAt: z.ZodNumber;
+}, z.core.$strip>;
+export declare const watcherPollStatusSchema: z.ZodObject<{
+    user: z.ZodString;
+    checkedAt: z.ZodNumber;
+    hasNowPlaying: z.ZodBoolean;
+    scrobblesFound: z.ZodNumber;
+}, z.core.$strip>;
+export declare const watcherOptionsSchema: z.ZodObject<{
+    user: z.ZodString;
+    intervalMs: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    idleThresholdMs: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    emitInitial: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    autoStart: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type WatcherTrack = z.infer<typeof watcherTrackSchema>;
+export type WatcherIdleStatus = z.infer<typeof watcherIdleStatusSchema>;
+export type WatcherPollStatus = z.infer<typeof watcherPollStatusSchema>;
+export type WatcherOptions = z.infer<typeof watcherOptionsSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/watcher/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/watcher/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;iBAU7B,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;iBAM/B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/watcher/schemas.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { imageSchema, userNameSchema } from '../core/schemas/index.js';
+export const watcherTrackSchema = z.object({
+    name: z.string(),
+    artist: z.string(),
+    album: z.string().optional(),
+    url: z.string().optional(),
+    image: z.array(imageSchema).optional(),
+    mbid: z.string().optional(),
+    nowPlaying: z.boolean(),
+    uts: z.number().int().optional(),
+    scrobbledAt: z.number().int().optional(),
+});
+export const watcherIdleStatusSchema = z.object({
+    user: userNameSchema,
+    lastSeenUts: z.number().int().nullable(),
+    idleMinutes: z.number().nonnegative(),
+    checkedAt: z.number().int(),
+});
+export const watcherPollStatusSchema = z.object({
+    user: userNameSchema,
+    checkedAt: z.number().int(),
+    hasNowPlaying: z.boolean(),
+    scrobblesFound: z.number().int().nonnegative(),
+});
+export const watcherOptionsSchema = z.object({
+    user: userNameSchema,
+    intervalMs: z.number().int().min(2_000).default(10_000).optional(),
+    idleThresholdMs: z.number().int().min(10_000).default(300_000).optional(),
+    emitInitial: z.boolean().default(true).optional(),
+    autoStart: z.boolean().default(false).optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/watcher/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/watcher/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC9C,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,cAAc;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IAClE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;IACzE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAA"}

package/dist/watcher/service.d.ts

@@ -0,0 +1,15 @@
+import type { UserService } from '../core/services/user.js';
+import type { WatcherOptions } from './schemas.js';
+import { ScrobbleWatcher } from './watcher.js';
+export interface WatcherService {
+    /**
+     * Creates a real-time event-driven scrobble watcher for a given user.
+     */
+    watchUser: (options: WatcherOptions) => ScrobbleWatcher;
+    /**
+     * Alias for `watchUser`.
+     */
+    create: (options: WatcherOptions) => ScrobbleWatcher;
+}
+export declare function createWatcherService(userService: UserService): WatcherService;
+//# sourceMappingURL=service.d.ts.map

package/dist/watcher/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/watcher/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,CAAA;IAEvD;;OAEG;IACH,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,CAAA;CACpD;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAK7E"}

package/dist/watcher/service.js

@@ -0,0 +1,8 @@
+import { ScrobbleWatcher } from './watcher.js';
+export function createWatcherService(userService) {
+    return {
+        watchUser: (options) => new ScrobbleWatcher(userService, options),
+        create: (options) => new ScrobbleWatcher(userService, options),
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/watcher/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/watcher/service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAc9C,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC5D,OAAO;QACN,SAAS,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC;QACjF,MAAM,EAAE,CAAC,OAAuB,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC;KAC9E,CAAA;AACF,CAAC"}

package/dist/watcher/watcher.d.ts

@@ -0,0 +1,35 @@
+import type { UserService } from '../core/services/user.js';
+import { TypedEventEmitter } from './emitter.js';
+import type { WatcherIdleStatus, WatcherOptions, WatcherPollStatus, WatcherTrack } from './schemas.js';
+export interface WatcherEvents extends Record<string, unknown[]> {
+    nowPlaying: [track: WatcherTrack];
+    nowPlayingEnd: [track: WatcherTrack];
+    scrobble: [track: WatcherTrack];
+    idle: [status: WatcherIdleStatus];
+    poll: [status: WatcherPollStatus];
+    error: [err: Error];
+}
+export declare class ScrobbleWatcher extends TypedEventEmitter<WatcherEvents> {
+    private readonly userService;
+    private readonly user;
+    private readonly intervalMs;
+    private readonly idleThresholdMs;
+    private readonly emitInitial;
+    private running;
+    private timer;
+    private lastNowPlayingKey;
+    private currentNowPlayingTrack;
+    private lastProcessedUts;
+    private lastActivityUts;
+    private isIdle;
+    private lastScrobbleTrack;
+    private polling;
+    constructor(userService: UserService, options: WatcherOptions);
+    start(): this;
+    stop(): this;
+    isRunning(): boolean;
+    getCurrentNowPlaying(): WatcherTrack | null;
+    getLastScrobble(): WatcherTrack | null;
+    pollOnce(): Promise<void>;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEtG,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC/D,UAAU,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACjC,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IAC/B,IAAI,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IACjC,IAAI,EAAE,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IACjC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;CACnB;AAED,qBAAa,eAAgB,SAAQ,iBAAiB,CAAC,aAAa,CAAC;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,sBAAsB,CAA4B;IAC1D,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,OAAO,CAAQ;gBAEX,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc;IAatD,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI;IASZ,SAAS,IAAI,OAAO;IAIpB,oBAAoB,IAAI,YAAY,GAAG,IAAI;IAI3C,eAAe,IAAI,YAAY,GAAG,IAAI;IAIhC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA6ItC"}