@ansango/lastfm-api 3.4.0 → 3.6.0

package/dist/cache/schemas.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export declare const cacheStoreStatsSchema: z.ZodObject<{
+    hits: z.ZodNumber;
+    misses: z.ZodNumber;
+    size: z.ZodNumber;
+}, z.core.$strip>;
+export declare const cacheOptionsSchema: z.ZodObject<{
+    defaultTtlMs: z.ZodOptional<z.ZodNumber>;
+    ttlByNamespace: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    ttlByMethod: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CacheStoreStatsPayload = z.infer<typeof cacheStoreStatsSchema>;
+export type CacheOptionsSchema = z.infer<typeof cacheOptionsSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/cache/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/dist/cache/schemas.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const cacheStoreStatsSchema = z.object({
+    hits: z.number().int().nonnegative(),
+    misses: z.number().int().nonnegative(),
+    size: z.number().int().nonnegative(),
+});
+export const cacheOptionsSchema = z.object({
+    defaultTtlMs: z.number().positive().optional(),
+    ttlByNamespace: z.record(z.string(), z.number().positive()).optional(),
+    ttlByMethod: z.record(z.string(), z.number().positive()).optional(),
+    enabled: z.boolean().optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/cache/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/cache/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACpC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;IACnE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAA"}

package/dist/cache/service.d.ts

@@ -0,0 +1,13 @@
+import type { CacheStoreStats } from './interface.js';
+import type { CacheManager } from './manager.js';
+export interface CacheService {
+    get: <T = unknown>(key: string) => Promise<T | undefined>;
+    set: <T = unknown>(key: string, value: T, ttlMs?: number) => Promise<void>;
+    delete: (key: string) => Promise<boolean>;
+    clear: () => Promise<void>;
+    has: (key: string) => Promise<boolean>;
+    stats: () => CacheStoreStats | undefined;
+    manager: CacheManager;
+}
+export declare function createCacheService(manager: CacheManager): CacheService;
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/cache/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACzD,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACzC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,KAAK,EAAE,MAAM,eAAe,GAAG,SAAS,CAAA;IACxC,OAAO,EAAE,YAAY,CAAA;CACrB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAUtE"}

package/dist/cache/service.js

@@ -0,0 +1,12 @@
+export function createCacheService(manager) {
+    return {
+        get: (key) => manager.get(key),
+        set: (key, value, ttlMs) => manager.set(key, value, ttlMs),
+        delete: (key) => manager.delete(key),
+        clear: () => manager.clear(),
+        has: (key) => manager.has(key),
+        stats: () => manager.stats(),
+        manager,
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/cache/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/cache/service.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACvD,OAAO;QACN,GAAG,EAAE,CAAc,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAI,GAAG,CAAC;QACtD,GAAG,EAAE,CAAc,GAAW,EAAE,KAAQ,EAAE,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC;QAC3F,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QAC5C,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QACtC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,OAAO;KACP,CAAA;AACF,CAAC"}

package/dist/cache/stores/memory.d.ts

@@ -0,0 +1,33 @@
+import type { CacheStore, CacheStoreStats } from '../interface.js';
+export interface MemoryCacheStoreOptions {
+    /**
+     * Maximum number of entries before oldest entries are evicted (default: 500)
+     */
+    maxEntries?: number;
+    /**
+     * Default TTL in milliseconds (default: 300,000 / 5 minutes)
+     */
+    defaultTtlMs?: number;
+}
+/**
+ * High-performance in-memory cache store with TTL expiration and LRU eviction.
+ */
+export declare class MemoryCacheStore implements CacheStore {
+    private readonly entries;
+    private readonly maxEntries;
+    private readonly defaultTtlMs;
+    private hitCount;
+    private missCount;
+    constructor(options?: MemoryCacheStoreOptions);
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T, ttlMs?: number): void;
+    delete(key: string): boolean;
+    clear(): void;
+    has(key: string): boolean;
+    stats(): CacheStoreStats;
+    /**
+     * Removes all expired entries from memory
+     */
+    pruneExpired(): number;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/cache/stores/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/cache/stores/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE,MAAM,WAAW,uBAAuB;IACvC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAOD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAI;gBAET,OAAO,GAAE,uBAA4B;IAK1C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAoB5C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAMb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzB,KAAK,IAAI,eAAe;IAS/B;;OAEG;IACI,YAAY,IAAI,MAAM;CAW7B"}

package/dist/cache/stores/memory.js

@@ -0,0 +1,85 @@
+/**
+ * High-performance in-memory cache store with TTL expiration and LRU eviction.
+ */
+export class MemoryCacheStore {
+    entries = new Map();
+    maxEntries;
+    defaultTtlMs;
+    hitCount = 0;
+    missCount = 0;
+    constructor(options = {}) {
+        this.maxEntries = options.maxEntries ?? 500;
+        this.defaultTtlMs = options.defaultTtlMs ?? 300_000;
+    }
+    get(key) {
+        const record = this.entries.get(key);
+        if (!record) {
+            this.missCount++;
+            return undefined;
+        }
+        if (Date.now() > record.expiresAt) {
+            this.entries.delete(key);
+            this.missCount++;
+            return undefined;
+        }
+        // Re-insert to refresh LRU order
+        this.entries.delete(key);
+        this.entries.set(key, record);
+        this.hitCount++;
+        return record.value;
+    }
+    set(key, value, ttlMs) {
+        const ttl = ttlMs ?? this.defaultTtlMs;
+        const expiresAt = Date.now() + ttl;
+        // Evict oldest entry if capacity reached
+        if (this.entries.size >= this.maxEntries && !this.entries.has(key)) {
+            const oldestKey = this.entries.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.entries.delete(oldestKey);
+            }
+        }
+        this.entries.delete(key);
+        this.entries.set(key, { value, expiresAt });
+    }
+    delete(key) {
+        return this.entries.delete(key);
+    }
+    clear() {
+        this.entries.clear();
+        this.hitCount = 0;
+        this.missCount = 0;
+    }
+    has(key) {
+        const record = this.entries.get(key);
+        if (!record)
+            return false;
+        if (Date.now() > record.expiresAt) {
+            this.entries.delete(key);
+            return false;
+        }
+        return true;
+    }
+    stats() {
+        this.pruneExpired();
+        return {
+            hits: this.hitCount,
+            misses: this.missCount,
+            size: this.entries.size,
+        };
+    }
+    /**
+     * Removes all expired entries from memory
+     */
+    pruneExpired() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [key, record] of this.entries.entries()) {
+            if (now > record.expiresAt) {
+                this.entries.delete(key);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/cache/stores/memory.js.map

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

package/dist/cache/stores/storage.d.ts

@@ -0,0 +1,42 @@
+import type { CacheStore, CacheStoreStats } from '../interface.js';
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+    readonly length: number;
+    key(index: number): string | null;
+}
+export interface StorageCacheStoreOptions {
+    /**
+     * Storage backend (defaults to globalThis.localStorage if available)
+     */
+    storage?: StorageLike;
+    /**
+     * Prefix for cache keys in storage to prevent collisions (default: 'lastfm_cache_')
+     */
+    prefix?: string;
+    /**
+     * Default TTL in milliseconds (default: 300,000 / 5 minutes)
+     */
+    defaultTtlMs?: number;
+}
+/**
+ * Persistent cache store using Web Storage (localStorage or sessionStorage).
+ */
+export declare class StorageCacheStore implements CacheStore {
+    private readonly storage;
+    private readonly prefix;
+    private readonly defaultTtlMs;
+    private hitCount;
+    private missCount;
+    constructor(options?: StorageCacheStoreOptions);
+    private prefixedKey;
+    get<T = unknown>(key: string): T | undefined;
+    set<T = unknown>(key: string, value: T, ttlMs?: number): void;
+    delete(key: string): boolean;
+    clear(): void;
+    has(key: string): boolean;
+    stats(): CacheStoreStats;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/cache/stores/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/cache/stores/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAElE,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,KAAK,IAAI,IAAI,CAAA;IACb,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CACjC;AAED,MAAM,WAAW,wBAAwB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAOD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAI;gBAET,OAAO,GAAE,wBAA6B;IAUlD,OAAO,CAAC,WAAW;IAIZ,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IA4B5C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5B,KAAK,IAAI,IAAI;IAgBb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,KAAK,IAAI,eAAe;CAgB/B"}

package/dist/cache/stores/storage.js

@@ -0,0 +1,109 @@
+/**
+ * Persistent cache store using Web Storage (localStorage or sessionStorage).
+ */
+export class StorageCacheStore {
+    storage;
+    prefix;
+    defaultTtlMs;
+    hitCount = 0;
+    missCount = 0;
+    constructor(options = {}) {
+        this.storage =
+            options.storage ??
+                (typeof globalThis !== 'undefined' && 'localStorage' in globalThis
+                    ? globalThis.localStorage
+                    : undefined);
+        this.prefix = options.prefix ?? 'lastfm_cache_';
+        this.defaultTtlMs = options.defaultTtlMs ?? 300_000;
+    }
+    prefixedKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    get(key) {
+        if (!this.storage) {
+            this.missCount++;
+            return undefined;
+        }
+        try {
+            const item = this.storage.getItem(this.prefixedKey(key));
+            if (!item) {
+                this.missCount++;
+                return undefined;
+            }
+            const parsed = JSON.parse(item);
+            if (Date.now() > parsed.expiresAt) {
+                this.storage.removeItem(this.prefixedKey(key));
+                this.missCount++;
+                return undefined;
+            }
+            this.hitCount++;
+            return parsed.value;
+        }
+        catch {
+            this.missCount++;
+            return undefined;
+        }
+    }
+    set(key, value, ttlMs) {
+        if (!this.storage)
+            return;
+        const ttl = ttlMs ?? this.defaultTtlMs;
+        const payload = {
+            value,
+            expiresAt: Date.now() + ttl,
+        };
+        try {
+            this.storage.setItem(this.prefixedKey(key), JSON.stringify(payload));
+        }
+        catch {
+            // Storage quota exceeded or disabled; fail gracefully
+        }
+    }
+    delete(key) {
+        if (!this.storage)
+            return false;
+        const fullKey = this.prefixedKey(key);
+        const exists = this.storage.getItem(fullKey) !== null;
+        if (exists) {
+            this.storage.removeItem(fullKey);
+            return true;
+        }
+        return false;
+    }
+    clear() {
+        if (!this.storage)
+            return;
+        const keysToRemove = [];
+        for (let i = 0; i < this.storage.length; i++) {
+            const k = this.storage.key(i);
+            if (k?.startsWith(this.prefix)) {
+                keysToRemove.push(k);
+            }
+        }
+        for (const k of keysToRemove) {
+            this.storage.removeItem(k);
+        }
+        this.hitCount = 0;
+        this.missCount = 0;
+    }
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    stats() {
+        let size = 0;
+        if (this.storage) {
+            for (let i = 0; i < this.storage.length; i++) {
+                const k = this.storage.key(i);
+                if (k?.startsWith(this.prefix)) {
+                    size++;
+                }
+            }
+        }
+        return {
+            hits: this.hitCount,
+            misses: this.missCount,
+            size,
+        };
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/cache/stores/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/cache/stores/storage.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACZ,OAAO,CAAyB;IAChC,MAAM,CAAQ;IACd,YAAY,CAAQ;IAC7B,QAAQ,GAAG,CAAC,CAAA;IACZ,SAAS,GAAG,CAAC,CAAA;IAErB,YAAY,UAAoC,EAAE;QACjD,IAAI,CAAC,OAAO;YACX,OAAO,CAAC,OAAO;gBACf,CAAC,OAAO,UAAU,KAAK,WAAW,IAAI,cAAc,IAAI,UAAU;oBACjE,CAAC,CAAE,UAAU,CAAC,YAAuC;oBACrD,CAAC,CAAC,SAAS,CAAC,CAAA;QACd,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAAA;QAC/C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAA;IACpD,CAAC;IAEO,WAAW,CAAC,GAAW;QAC9B,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAA;IAC9B,CAAC;IAEM,GAAG,CAAc,GAAW;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,EAAE,CAAA;YAChB,OAAO,SAAS,CAAA;QACjB,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;YACxD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACX,IAAI,CAAC,SAAS,EAAE,CAAA;gBAChB,OAAO,SAAS,CAAA;YACjB,CAAC;YAED,MAAM,MAAM,GAAqB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACjD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;gBAC9C,IAAI,CAAC,SAAS,EAAE,CAAA;gBAChB,OAAO,SAAS,CAAA;YACjB,CAAC;YAED,IAAI,CAAC,QAAQ,EAAE,CAAA;YACf,OAAO,MAAM,CAAC,KAAK,CAAA;QACpB,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,SAAS,EAAE,CAAA;YAChB,OAAO,SAAS,CAAA;QACjB,CAAC;IACF,CAAC;IAEM,GAAG,CAAc,GAAW,EAAE,KAAQ,EAAE,KAAc;QAC5D,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEzB,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,YAAY,CAAA;QACtC,MAAM,OAAO,GAAqB;YACjC,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG;SAC3B,CAAA;QAED,IAAI,CAAC;YACJ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;QACrE,CAAC;QAAC,MAAM,CAAC;YACR,sDAAsD;QACvD,CAAC;IACF,CAAC;IAEM,MAAM,CAAC,GAAW;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAA;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;QACrD,IAAI,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAChC,OAAO,IAAI,CAAA;QACZ,CAAC;QACD,OAAO,KAAK,CAAA;IACb,CAAC;IAEM,KAAK;QACX,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QACzB,MAAM,YAAY,GAAa,EAAE,CAAA;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC7B,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACrB,CAAC;QACF,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC3B,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;QACjB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAA;IACnB,CAAC;IAEM,GAAG,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAA;IACnC,CAAC;IAEM,KAAK;QACX,IAAI,IAAI,GAAG,CAAC,CAAA;QACZ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAC7B,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBAChC,IAAI,EAAE,CAAA;gBACP,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,MAAM,EAAE,IAAI,CAAC,SAAS;YACtB,IAAI;SACJ,CAAA;IACF,CAAC;CACD"}

package/dist/client.d.ts

@@ -1,5 +1,11 @@
+import { type CacheService } from './cache/index.js';
 import type { LastFmConfig } from './config.js';
-import { type AlbumService, type ArtistService, type AuthService, type ChartService, type GeoService, type InsightsService, type LibraryService, type TagService, type TrackService, type UserService } from './services/index.js';
+import { type AlbumService, type ArtistService, type AuthService, type ChartService, type GeoService, type LibraryService, type TagService, type TrackService, type UserService } from './core/services/index.js';
+import { type ExporterService } from './exporter/index.js';
+import { type InsightsService } from './insights/index.js';
+import { type PlaylistsService } from './playlists/index.js';
+import { type ReportsService } from './reports/index.js';
+import { type WatcherService } from './watcher/index.js';
 /**
  * Last.fm API Client
  *
@@ -30,6 +36,11 @@ export declare class LastFmClient {
     readonly library: LibraryService;
     readonly auth: AuthService;
     readonly insights: InsightsService;
+    readonly reports: ReportsService;
+    readonly playlists: PlaylistsService;
+    readonly exporter: ExporterService;
+    readonly cache: CacheService;
+    readonly watcher: WatcherService;
     private readonly config;
     constructor(config?: Partial<LastFmConfig>);
     /**

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAWjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAA;AAE5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACxB,SAAgB,IAAI,EAAE,WAAW,CAAA;IACjC,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,MAAM,EAAE,aAAa,CAAA;IACrC,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,GAAG,EAAE,UAAU,CAAA;IAC/B,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,GAAG,EAAE,UAAU,CAAA;IAC/B,SAAgB,OAAO,EAAE,cAAc,CAAA;IACvC,SAAgB,IAAI,EAAE,WAAW,CAAA;IACjC,SAAgB,QAAQ,EAAE,eAAe,CAAA;IAEzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAgB1C;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;CAGnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEzE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,YAAY,EAAsB,MAAM,kBAAkB,CAAA;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAUjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACxB,SAAgB,IAAI,EAAE,WAAW,CAAA;IACjC,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,MAAM,EAAE,aAAa,CAAA;IACrC,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,GAAG,EAAE,UAAU,CAAA;IAC/B,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,GAAG,EAAE,UAAU,CAAA;IAC/B,SAAgB,OAAO,EAAE,cAAc,CAAA;IACvC,SAAgB,IAAI,EAAE,WAAW,CAAA;IACjC,SAAgB,QAAQ,EAAE,eAAe,CAAA;IACzC,SAAgB,OAAO,EAAE,cAAc,CAAA;IACvC,SAAgB,SAAS,EAAE,gBAAgB,CAAA;IAC3C,SAAgB,QAAQ,EAAE,eAAe,CAAA;IACzC,SAAgB,KAAK,EAAE,YAAY,CAAA;IACnC,SAAgB,OAAO,EAAE,cAAc,CAAA;IAEvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IA0B1C;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;CAGnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAEzE"}

package/dist/client.js

@@ -1,5 +1,11 @@
+import { CacheManager, createCacheService } from './cache/index.js';
 import { createConfig, getGlobalConfig } from './config.js';
-import { createAlbumService, createArtistService, createAuthService, createChartService, createGeoService, createInsightsService, createLibraryService, createTagService, createTrackService, createUserService, } from './services/index.js';
+import { createAlbumService, createArtistService, createAuthService, createChartService, createGeoService, createLibraryService, createTagService, createTrackService, createUserService, } from './core/services/index.js';
+import { createExporterService } from './exporter/index.js';
+import { createInsightsService } from './insights/index.js';
+import { createPlaylistsService } from './playlists/index.js';
+import { createReportsService } from './reports/index.js';
+import { createWatcherService } from './watcher/index.js';
 /**
  * Last.fm API Client
  *
@@ -30,9 +36,19 @@ export class LastFmClient {
     library;
     auth;
     insights;
+    reports;
+    playlists;
+    exporter;
+    cache;
+    watcher;
     config;
     constructor(config) {
         this.config = config ? createConfig(config) : getGlobalConfig();
+        // Ensure cache manager exists for cache operations
+        if (!this.config.cacheManager) {
+            this.config.cacheManager = new CacheManager({ enabled: false });
+        }
+        this.cache = createCacheService(this.config.cacheManager);
         // Initialize all services
         this.user = createUserService(this.config);
         this.album = createAlbumService(this.config);
@@ -44,6 +60,10 @@ export class LastFmClient {
         this.library = createLibraryService(this.config);
         this.auth = createAuthService(this.config);
         this.insights = createInsightsService(this.config);
+        this.reports = createReportsService(this.config);
+        this.playlists = createPlaylistsService(this.config);
+        this.exporter = createExporterService(this.config);
+        this.watcher = createWatcherService(this.user);
     }
     /**
      * Get the current configuration (read-only)

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAKN,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAOjB,MAAM,qBAAqB,CAAA;AAE5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,YAAY;IACR,IAAI,CAAa;IACjB,KAAK,CAAc;IACnB,MAAM,CAAe;IACrB,KAAK,CAAc;IACnB,GAAG,CAAY;IACf,KAAK,CAAc;IACnB,GAAG,CAAY;IACf,OAAO,CAAgB;IACvB,IAAI,CAAa;IACjB,QAAQ,CAAiB;IAExB,MAAM,CAAc;IAErC,YAAY,MAA8B;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAA;QAE/D,0BAA0B;QAC1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9C,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACxC,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC1B,CAAC;CACD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8B;IAC1D,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;AAChC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,8 +1,12 @@
+import type { CacheOptions, CacheStore } from './cache/interface.js';
+import { CacheManager } from './cache/manager.js';
 export interface LastFmConfig {
     apiKey: string;
     sharedSecret?: string;
     sessionKey?: string;
     baseUrl?: string;
+    cache?: CacheOptions | CacheStore | boolean;
+    cacheManager?: CacheManager;
 }
 /**
  * Crea una nueva configuración validada

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AA6BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAU9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,OAAO,CAAA;IAC3C,YAAY,CAAC,EAAE,YAAY,CAAA;CAC3B;AA6BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,YAAY,CAsB9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/config.js

@@ -1,3 +1,4 @@
+import { CacheManager } from './cache/manager.js';
 let globalConfig = null;
 /**
  * Carga configuración desde variables de entorno (solo Node.js)
@@ -33,6 +34,18 @@ export function createConfig(options = {}) {
         ...options,
     };
     validateConfig(config);
+    // Resolve cache manager if cache option was specified
+    if (options.cache !== undefined && !config.cacheManager) {
+        if (typeof options.cache === 'boolean') {
+            config.cacheManager = new CacheManager({ enabled: options.cache });
+        }
+        else if (typeof options.cache.get === 'function') {
+            config.cacheManager = new CacheManager({ store: options.cache });
+        }
+        else {
+            config.cacheManager = new CacheManager(options.cache);
+        }
+    }
     return config;
 }
 /**

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,IAAI,YAAY,GAAwB,IAAI,CAAA;AAE5C;;GAEG;AACH,SAAS,aAAa;IACrB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;YAC9C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;YAC1C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;SACpC,CAAA;IACF,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAA6B;IACpD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAA;IAC9G,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAiC,EAAE;IAC/D,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;IACjC,MAAM,MAAM,GAAG;QACd,OAAO,EAAE,oCAAoC;QAC7C,GAAG,SAAS;QACZ,GAAG,OAAO;KACV,CAAA;IAED,cAAc,CAAC,MAAM,CAAC,CAAA;IACtB,OAAO,MAAsB,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC5D,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,YAAY,GAAG,YAAY,EAAE,CAAA;IAC9B,CAAC;IACD,OAAO,YAAY,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAChC,YAAY,GAAG,IAAI,CAAA;AACpB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAWjD,IAAI,YAAY,GAAwB,IAAI,CAAA;AAE5C;;GAEG;AACH,SAAS,aAAa;IACrB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO;YACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;YAC9C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB;YAC1C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;SACpC,CAAA;IACF,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,MAA6B;IACpD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAA;IAC9G,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAiC,EAAE;IAC/D,MAAM,SAAS,GAAG,aAAa,EAAE,CAAA;IACjC,MAAM,MAAM,GAAiB;QAC5B,OAAO,EAAE,oCAAoC;QAC7C,GAAG,SAAS;QACZ,GAAG,OAAO;KACM,CAAA;IAEjB,cAAc,CAAC,MAAM,CAAC,CAAA;IAEtB,sDAAsD;IACtD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzD,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QACnE,CAAC;aAAM,IAAI,OAAQ,OAAO,CAAC,KAAoB,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACpE,MAAM,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAmB,EAAE,CAAC,CAAA;QAC/E,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,KAAqB,CAAC,CAAA;QACtE,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC5D,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,YAAY,GAAG,YAAY,EAAE,CAAA;IAC9B,CAAC;IACD,OAAO,YAAY,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAChC,YAAY,GAAG,IAAI,CAAA;AACpB,CAAC"}

package/dist/core/canonical-methods.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Canonical Last.fm method inventory.
+ *
+ * Single source of truth for the "56/56" coverage of the Last.fm API.
+ * (was 57/57; `auth.getMobileSession` removed in v4.0.0 — see #117.)
+ * Consumed by:
+ *  - `src/__tests__/inventory.test.ts` — verifies that each method exists on the client
+ *  - `src/method-registry.ts` — wires the docs tool (Hono + Scalar)
+ *
+ * Rules:
+ *  - Only canonical Last.fm `namespace.method` pairs go here.
+ *  - Wrapper/alias methods (e.g. `scrobbleMany`, `postTrackScrobble`,
+ *    `postBatchTrackScrobble`) are excluded because they all target the
+ *    same canonical endpoint (`track.scrobble`) and must not be
+ *    double-counted.
+ *
+ * The per-namespace breakdown:
+ *  - artist (10), album (6), track (12), user (13), tag (7),
+ *    chart (3), geo (2), library (1), auth (3) = 57
+ */
+export declare const CANONICAL_METHODS: readonly ["artist.getInfo", "artist.getTags", "artist.getSimilar", "artist.getTopTags", "artist.getTopAlbums", "artist.getTopTracks", "artist.search", "artist.getCorrection", "artist.addTags", "artist.removeTag", "album.getInfo", "album.getTags", "album.getTopTags", "album.search", "album.addTags", "album.removeTag", "track.getInfo", "track.getSimilar", "track.getTags", "track.getTopTags", "track.search", "track.getCorrection", "track.addTags", "track.removeTag", "track.love", "track.unlove", "track.updateNowPlaying", "track.scrobble", "user.getInfo", "user.getFriends", "user.getLovedTracks", "user.getRecentTracks", "user.getTopAlbums", "user.getTopArtists", "user.getTopTags", "user.getTopTracks", "user.getWeeklyAlbumChart", "user.getWeeklyArtistChart", "user.getWeeklyChartList", "user.getWeeklyTrackChart", "user.getPersonalTags", "tag.getInfo", "tag.getSimilar", "tag.getTopAlbums", "tag.getTopArtists", "tag.getTopTags", "tag.getTopTracks", "tag.getWeeklyChartList", "chart.getTopArtists", "chart.getTopTags", "chart.getTopTracks", "geo.getTopArtists", "geo.getTopTracks", "library.getArtists", "auth.getSession", "auth.getToken"];
+export type CanonicalMethodId = (typeof CANONICAL_METHODS)[number];
+export type CanonicalMethod = CanonicalMethodId;
+export type Namespace = CanonicalMethodId extends `${infer N}.${string}` ? N : never;
+//# sourceMappingURL=canonical-methods.d.ts.map

package/dist/core/canonical-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-methods.d.ts","sourceRoot":"","sources":["../../src/core/canonical-methods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,0nCAkEpB,CAAA;AAEV,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAClE,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAA;AAC/C,MAAM,MAAM,SAAS,GAAG,iBAAiB,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA"}

package/dist/core/canonical-methods.js

@@ -0,0 +1,88 @@
+/**
+ * Canonical Last.fm method inventory.
+ *
+ * Single source of truth for the "56/56" coverage of the Last.fm API.
+ * (was 57/57; `auth.getMobileSession` removed in v4.0.0 — see #117.)
+ * Consumed by:
+ *  - `src/__tests__/inventory.test.ts` — verifies that each method exists on the client
+ *  - `src/method-registry.ts` — wires the docs tool (Hono + Scalar)
+ *
+ * Rules:
+ *  - Only canonical Last.fm `namespace.method` pairs go here.
+ *  - Wrapper/alias methods (e.g. `scrobbleMany`, `postTrackScrobble`,
+ *    `postBatchTrackScrobble`) are excluded because they all target the
+ *    same canonical endpoint (`track.scrobble`) and must not be
+ *    double-counted.
+ *
+ * The per-namespace breakdown:
+ *  - artist (10), album (6), track (12), user (13), tag (7),
+ *    chart (3), geo (2), library (1), auth (3) = 57
+ */
+export const CANONICAL_METHODS = [
+    // artist (10)
+    'artist.getInfo',
+    'artist.getTags',
+    'artist.getSimilar',
+    'artist.getTopTags',
+    'artist.getTopAlbums',
+    'artist.getTopTracks',
+    'artist.search',
+    'artist.getCorrection',
+    'artist.addTags',
+    'artist.removeTag',
+    // album (6)
+    'album.getInfo',
+    'album.getTags',
+    'album.getTopTags',
+    'album.search',
+    'album.addTags',
+    'album.removeTag',
+    // track (12)
+    'track.getInfo',
+    'track.getSimilar',
+    'track.getTags',
+    'track.getTopTags',
+    'track.search',
+    'track.getCorrection',
+    'track.addTags',
+    'track.removeTag',
+    'track.love',
+    'track.unlove',
+    'track.updateNowPlaying',
+    'track.scrobble',
+    // user (13)
+    'user.getInfo',
+    'user.getFriends',
+    'user.getLovedTracks',
+    'user.getRecentTracks',
+    'user.getTopAlbums',
+    'user.getTopArtists',
+    'user.getTopTags',
+    'user.getTopTracks',
+    'user.getWeeklyAlbumChart',
+    'user.getWeeklyArtistChart',
+    'user.getWeeklyChartList',
+    'user.getWeeklyTrackChart',
+    'user.getPersonalTags',
+    // tag (7)
+    'tag.getInfo',
+    'tag.getSimilar',
+    'tag.getTopAlbums',
+    'tag.getTopArtists',
+    'tag.getTopTags',
+    'tag.getTopTracks',
+    'tag.getWeeklyChartList',
+    // chart (3)
+    'chart.getTopArtists',
+    'chart.getTopTags',
+    'chart.getTopTracks',
+    // geo (2)
+    'geo.getTopArtists',
+    'geo.getTopTracks',
+    // library (1)
+    'library.getArtists',
+    // auth (2)
+    'auth.getSession',
+    'auth.getToken',
+];
+//# sourceMappingURL=canonical-methods.js.map

package/dist/core/canonical-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-methods.js","sourceRoot":"","sources":["../../src/core/canonical-methods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,mBAAmB;IACnB,qBAAqB;IACrB,qBAAqB;IACrB,eAAe;IACf,sBAAsB;IACtB,gBAAgB;IAChB,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,eAAe;IACf,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,cAAc;IACd,qBAAqB;IACrB,eAAe;IACf,iBAAiB;IACjB,YAAY;IACZ,cAAc;IACd,wBAAwB;IACxB,gBAAgB;IAChB,YAAY;IACZ,cAAc;IACd,iBAAiB;IACjB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,oBAAoB;IACpB,iBAAiB;IACjB,mBAAmB;IACnB,0BAA0B;IAC1B,2BAA2B;IAC3B,yBAAyB;IACzB,0BAA0B;IAC1B,sBAAsB;IACtB,UAAU;IACV,aAAa;IACb,gBAAgB;IAChB,kBAAkB;IAClB,mBAAmB;IACnB,gBAAgB;IAChB,kBAAkB;IAClB,wBAAwB;IACxB,YAAY;IACZ,qBAAqB;IACrB,kBAAkB;IAClB,oBAAoB;IACpB,UAAU;IACV,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;IACd,oBAAoB;IACpB,WAAW;IACX,iBAAiB;IACjB,eAAe;CACN,CAAA"}