@ansango/lastfm-api 3.4.0 → 3.5.0

package/README.md

@@ -276,7 +276,7 @@ if (result.success) {
 
 ## Insights & Analytics Engine
 
-The package includes a built-in analytics engine providing 9 high-level derived views computed over Last.fm data:
+The package includes a comprehensive, built-in analytics engine providing 20 high-level derived views and statistical metrics computed over Last.fm data:
 
 ```typescript
 import { createClient } from '@ansango/lastfm-api';
@@ -319,6 +319,133 @@ console.log(`Archetype: ${personality.archetype.emoji} ${personality.archetype.n
 // 9. User-to-User Taste Clash (Jaccard Similarity)
 const comparison = await client.insights.compareUsers({ userA: 'ansango', userB: 'friend' });
 console.log(`Taste Compatibility: ${comparison.compatibilityScore}% (Jaccard: ${comparison.jaccard})`);
+
+// 10. Obscurity & Hipster Score (Hidden Gems & Mainstream Anchors)
+const obscurity = await client.insights.getObscurityScore({ user: 'ansango', limit: 20 });
+console.log(`Score: ${obscurity.obscurityScore}/100 (${obscurity.category})`);
+
+// 11. Forgotten Favorites (Revival Candidates)
+const forgotten = await client.insights.getForgottenFavorites({ user: 'ansango', historicPeriod: '12month', recentPeriod: '1month' });
+
+// 12. Listening Obsession Episodes
+const obsessions = await client.insights.getObsessions({ user: 'ansango', windowSize: 20, thresholdRatio: 0.35 });
+
+// 13. Consecutive Daily Streaks & Dry Spells
+const streaks = await client.insights.getListeningStreaks({ user: 'ansango' });
+console.log(`Longest Streak: ${streaks.longestStreakDays} days`);
+
+// 14. 365-Day Daily Heatmap
+const heatmap = await client.insights.getListeningHeatmap({ user: 'ansango', days: 90 });
+
+// 15. Album Habits & Cohesion Score (Album Purist vs Playlist Shuffler)
+const habits = await client.insights.getAlbumHabits({ user: 'ansango', minSessionTracks: 3 });
+console.log(`Cohesion: ${habits.cohesionScore}% (${habits.profile})`);
+
+// 16. Genre Breakdown with HHI Concentration Index
+const genres = await client.insights.getGenreBreakdown({ user: 'ansango', period: 'overall' });
+console.log(`Specialization: ${genres.specializationLevel} (HHI: ${genres.hhiIndex})`);
+
+// 17. Genre Evolution & Temporal Shifts (Rising, Fading, New)
+const evolution = await client.insights.getGenreEvolution({ user: 'ansango', currentPeriod: '1month', previousPeriod: '12month' });
+
+// 18. Smart Similarity Graph Recommendations
+const recs = await client.insights.getSmartRecommendations({ user: 'ansango', seedLimit: 5, limit: 10 });
+
+// 19. Bridge Artists Connecting Two Disparate Genres
+const bridges = await client.insights.getBridgeArtists({ tagA: 'post-punk', tagB: 'electronic' });
+
+// 20. Multi-User Taste Group Comparison (Consensus & Outlier Detection)
+const group = await client.insights.compareTasteGroup({ users: ['alice', 'bob', 'carol'], period: 'overall' });
+console.log(`Group Average Compatibility: ${group.groupAverageCompatibility}%`);
+```
+
+## Reports & Wrapped Engine
+
+Generate shareable annual recaps, historical milestones, and monthly digests:
+
+```typescript
+import { createClient } from '@ansango/lastfm-api';
+
+const client = createClient();
+
+// 1. Year in Review / Wrapped
+const wrapped = await client.reports.getWrapped({ user: 'ansango', year: 2024 });
+console.log(`Top Artist of the Year: ${wrapped.topArtists[0].name}`);
+console.log(`Summer Anthem: ${wrapped.seasons.summer.topTrack} by ${wrapped.seasons.summer.topArtist}`);
+console.log(`Busiest Day: ${wrapped.busiestDay.date} (${wrapped.busiestDay.scrobbles} plays)`);
+
+// 2. Scrobble Milestones Tracker & Projection
+const milestones = await client.reports.getMilestones({ user: 'ansango', targets: [1000, 5000, 10000, 50000] });
+console.log(`Next milestone: ${milestones.nextMilestone.target} scrobbles (ETA: ${milestones.nextMilestone.projectedDate})`);
+
+// 3. Monthly Comparative Digest
+const digest = await client.reports.getMonthlyDigest({ user: 'ansango', year: 2024, month: 2 });
+console.log(`Growth vs previous month: ${digest.growthPercentage}%`);
+```
+
+## Smart Playlists Generator
+
+Algorithmic playlist creation with direct export to standard formats:
+
+```typescript
+import { createClient } from '@ansango/lastfm-api';
+
+const client = createClient();
+
+// Generate smart playlist (time-capsule, deep-cuts, heavy-rotation, discovery-radar)
+const playlist = await client.playlists.generate({
+  user: 'ansango',
+  mode: 'time-capsule',
+  limit: 25,
+});
+
+// Pre-rendered standard formats:
+console.log(playlist.formats.m3u); // Standard #EXTM3U playlist file content
+console.log(playlist.formats.csv); // CSV spreadsheet
+console.log(playlist.formats.spotifyQueries); // Spotify search query list
+```
+
+## Bulk Data Exporter & Backup
+
+Resilient scrobble history export with checkpointing and multiple output formats:
+
+```typescript
+import { createClient } from '@ansango/lastfm-api';
+
+const client = createClient();
+
+// Export scrobbles with ListenBrainz / JSONL / CSV formatting & checkpointing
+const exportData = await client.exporter.exportScrobbles({
+  user: 'ansango',
+  format: 'listenbrainz', // 'json' | 'jsonl' | 'csv' | 'listenbrainz'
+  limit: 1000,
+});
+
+// Resumable checkpoint timestamp
+console.log(`Resume from: ${exportData.nextCheckpointUts}`);
+```
+
+## Async Pagination & Streaming Iterators
+
+Stream large Last.fm datasets seamlessly using standard `for await` loops:
+
+```typescript
+import { createClient, iterateItems } from '@ansango/lastfm-api';
+
+const client = createClient();
+
+for await (const track of iterateItems(
+  (params) => client.user.getRecentTracks(params),
+  (res) => ({
+    items: res.recenttracks?.track ?? [],
+    totalPages: Number(res.recenttracks?.['@attr']?.totalPages ?? 1),
+    currentPage: Number(res.recenttracks?.['@attr']?.page ?? 1),
+  }),
+  { user: 'ansango', limit: 200 },
+  { maxItems: 1000 }
+)) {
+  console.log(`${track.name} - ${track.artist['#text']}`);
+}
 ```
 
 ## Environment Variables

package/dist/client.d.ts

@@ -1,5 +1,9 @@
 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';
 /**
  * Last.fm API Client
  *
@@ -30,6 +34,9 @@ export declare class LastFmClient {
     readonly library: LibraryService;
     readonly auth: AuthService;
     readonly insights: InsightsService;
+    readonly reports: ReportsService;
+    readonly playlists: PlaylistsService;
+    readonly exporter: ExporterService;
     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,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;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;IAEzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAmB1C;;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,9 @@
 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';
 /**
  * Last.fm API Client
  *
@@ -30,6 +34,9 @@ export class LastFmClient {
     library;
     auth;
     insights;
+    reports;
+    playlists;
+    exporter;
     config;
     constructor(config) {
         this.config = config ? createConfig(config) : getGlobalConfig();
@@ -44,6 +51,9 @@ 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);
     }
     /**
      * 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":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAKN,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAMjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAE,qBAAqB,EAAwB,MAAM,qBAAqB,CAAA;AACjF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAA;AAE9E;;;;;;;;;;;;;;;;;;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;IACzB,OAAO,CAAgB;IACvB,SAAS,CAAkB;IAC3B,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;QAClD,IAAI,CAAC,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAChD,IAAI,CAAC,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACpD,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"}

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"}

package/dist/core/client.d.ts

@@ -0,0 +1,33 @@
+import { type LastFmConfig } from '../config.js';
+import { type AlbumService, type ArtistService, type AuthService, type ChartService, type GeoService, type LibraryService, type TagService, type TrackService, type UserService } from './services/index.js';
+/**
+ * Lightweight Last.fm Core API client.
+ *
+ * Provides access strictly to the 56 canonical Last.fm REST API methods
+ * across the 9 official namespaces.
+ */
+export declare class LastFmCoreClient {
+    readonly user: UserService;
+    readonly album: AlbumService;
+    readonly artist: ArtistService;
+    readonly track: TrackService;
+    readonly tag: TagService;
+    readonly chart: ChartService;
+    readonly geo: GeoService;
+    readonly library: LibraryService;
+    readonly auth: AuthService;
+    private readonly config;
+    constructor(config?: Partial<LastFmConfig>);
+    /**
+     * Get the current configuration (read-only)
+     */
+    getConfig(): Readonly<LastFmConfig>;
+}
+/**
+ * Helper function to create a Last.fm core client instance
+ *
+ * @param config - Optional configuration. If not provided, uses global config.
+ * @returns A new LastFmCoreClient instance
+ */
+export declare function createCoreClient(config?: Partial<LastFmConfig>): LastFmCoreClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAC/E,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,qBAAqB,CAAA;AAE5B;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC5B,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;IAEjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAc1C;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;CAGnC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAEjF"}

package/dist/core/client.js

@@ -0,0 +1,48 @@
+import { createConfig, getGlobalConfig } from '../config.js';
+import { createAlbumService, createArtistService, createAuthService, createChartService, createGeoService, createLibraryService, createTagService, createTrackService, createUserService, } from './services/index.js';
+/**
+ * Lightweight Last.fm Core API client.
+ *
+ * Provides access strictly to the 56 canonical Last.fm REST API methods
+ * across the 9 official namespaces.
+ */
+export class LastFmCoreClient {
+    user;
+    album;
+    artist;
+    track;
+    tag;
+    chart;
+    geo;
+    library;
+    auth;
+    config;
+    constructor(config) {
+        this.config = config ? createConfig(config) : getGlobalConfig();
+        this.user = createUserService(this.config);
+        this.album = createAlbumService(this.config);
+        this.artist = createArtistService(this.config);
+        this.track = createTrackService(this.config);
+        this.tag = createTagService(this.config);
+        this.chart = createChartService(this.config);
+        this.geo = createGeoService(this.config);
+        this.library = createLibraryService(this.config);
+        this.auth = createAuthService(this.config);
+    }
+    /**
+     * Get the current configuration (read-only)
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+/**
+ * Helper function to create a Last.fm core client instance
+ *
+ * @param config - Optional configuration. If not provided, uses global config.
+ * @returns A new LastFmCoreClient instance
+ */
+export function createCoreClient(config) {
+    return new LastFmCoreClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/core/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/core/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAA;AAC/E,OAAO,EAKN,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAMjB,MAAM,qBAAqB,CAAA;AAE5B;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACZ,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;IAEhB,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,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;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC1B,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC9D,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './canonical-methods.js';
+export * from './client.js';
+export * from './pagination.js';
+export * from './schemas/index.js';
+export * from './services/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from './canonical-methods.js';
+export * from './client.js';
+export * from './pagination.js';
+export * from './schemas/index.js';
+export * from './services/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/dist/core/pagination.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Generic pagination and async iterator utilities for Last.fm API endpoints.
+ */
+export interface PaginationOptions {
+    /** Starting page number (1-indexed). Defaults to 1. */
+    startPage?: number;
+    /** Maximum number of pages to fetch. Defaults to Infinity. */
+    maxPages?: number;
+    /** Maximum total items to yield or collect. Defaults to Infinity. */
+    maxItems?: number;
+    /** Optional delay in milliseconds between page requests (for gentle rate limiting). Defaults to 0. */
+    delayMs?: number;
+}
+export interface PageExtraction<TItem> {
+    items: TItem[];
+    totalPages: number;
+    currentPage: number;
+}
+/**
+ * Async generator yielding items across all paginated responses one by one.
+ *
+ * @example
+ * ```typescript
+ * for await (const track of iterateItems(
+ *   (p) => client.user.getRecentTracks(p),
+ *   (res) => ({
+ *     items: res.recenttracks?.track ?? [],
+ *     totalPages: Number(res.recenttracks?.['@attr']?.totalPages ?? 1),
+ *     currentPage: Number(res.recenttracks?.['@attr']?.page ?? 1)
+ *   }),
+ *   { user: 'ansango', limit: 200 },
+ *   { maxItems: 1000 }
+ * )) {
+ *   console.log(track.name);
+ * }
+ * ```
+ */
+export declare function iterateItems<TItem, TParams extends Record<string, unknown>, TResponse>(fetchPage: (params: TParams & {
+    page: number;
+    limit?: number;
+}) => Promise<TResponse>, extract: (response: TResponse) => PageExtraction<TItem>, params: TParams, options?: PaginationOptions): AsyncGenerator<TItem, void, undefined>;
+/**
+ * Collects all items from paginated requests into an in-memory array.
+ */
+export declare function collectAll<TItem, TParams extends Record<string, unknown>, TResponse>(fetchPage: (params: TParams & {
+    page: number;
+    limit?: number;
+}) => Promise<TResponse>, extract: (response: TResponse) => PageExtraction<TItem>, params: TParams, options?: PaginationOptions): Promise<TItem[]>;
+/**
+ * Async generator yielding whole page responses one by one.
+ */
+export declare function iteratePages<TParams extends Record<string, unknown>, TResponse>(fetchPage: (params: TParams & {
+    page: number;
+    limit?: number;
+}) => Promise<TResponse>, extractPagination: (response: TResponse) => {
+    totalPages: number;
+    currentPage: number;
+}, params: TParams, options?: PaginationOptions): AsyncGenerator<TResponse, void, undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/core/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IACjC,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,KAAK;IACpC,KAAK,EAAE,KAAK,EAAE,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,YAAY,CAAC,KAAK,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAC5F,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EACrF,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,cAAc,CAAC,KAAK,CAAC,EACvD,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,iBAAsB,GAC7B,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAuCxC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EACzF,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EACrF,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,cAAc,CAAC,KAAK,CAAC,EACvD,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,iBAAsB,GAC7B,OAAO,CAAC,KAAK,EAAE,CAAC,CAMlB;AAED;;GAEG;AACH,wBAAuB,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EACrF,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,SAAS,CAAC,EACrF,iBAAiB,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACvF,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,iBAAsB,GAC7B,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CA0B5C"}

package/dist/core/pagination.js

@@ -0,0 +1,93 @@
+/**
+ * Generic pagination and async iterator utilities for Last.fm API endpoints.
+ */
+/**
+ * Async generator yielding items across all paginated responses one by one.
+ *
+ * @example
+ * ```typescript
+ * for await (const track of iterateItems(
+ *   (p) => client.user.getRecentTracks(p),
+ *   (res) => ({
+ *     items: res.recenttracks?.track ?? [],
+ *     totalPages: Number(res.recenttracks?.['@attr']?.totalPages ?? 1),
+ *     currentPage: Number(res.recenttracks?.['@attr']?.page ?? 1)
+ *   }),
+ *   { user: 'ansango', limit: 200 },
+ *   { maxItems: 1000 }
+ * )) {
+ *   console.log(track.name);
+ * }
+ * ```
+ */
+export async function* iterateItems(fetchPage, extract, params, options = {}) {
+    const startPage = options.startPage ?? 1;
+    const maxPages = options.maxPages ?? Number.POSITIVE_INFINITY;
+    const maxItems = options.maxItems ?? Number.POSITIVE_INFINITY;
+    const delayMs = options.delayMs ?? 0;
+    let currentPage = startPage;
+    let pagesFetched = 0;
+    let itemsYielded = 0;
+    while (pagesFetched < maxPages && itemsYielded < maxItems) {
+        const response = await fetchPage({
+            ...params,
+            page: currentPage,
+        });
+        pagesFetched++;
+        const { items, totalPages } = extract(response);
+        const itemList = Array.isArray(items) ? items : [items];
+        for (const item of itemList) {
+            if (!item)
+                continue;
+            yield item;
+            itemsYielded++;
+            if (itemsYielded >= maxItems) {
+                return;
+            }
+        }
+        if (currentPage >= totalPages || items.length === 0) {
+            break;
+        }
+        currentPage++;
+        if (delayMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+}
+/**
+ * Collects all items from paginated requests into an in-memory array.
+ */
+export async function collectAll(fetchPage, extract, params, options = {}) {
+    const collected = [];
+    for await (const item of iterateItems(fetchPage, extract, params, options)) {
+        collected.push(item);
+    }
+    return collected;
+}
+/**
+ * Async generator yielding whole page responses one by one.
+ */
+export async function* iteratePages(fetchPage, extractPagination, params, options = {}) {
+    const startPage = options.startPage ?? 1;
+    const maxPages = options.maxPages ?? Number.POSITIVE_INFINITY;
+    const delayMs = options.delayMs ?? 0;
+    let currentPage = startPage;
+    let pagesFetched = 0;
+    while (pagesFetched < maxPages) {
+        const response = await fetchPage({
+            ...params,
+            page: currentPage,
+        });
+        pagesFetched++;
+        yield response;
+        const { totalPages } = extractPagination(response);
+        if (currentPage >= totalPages) {
+            break;
+        }
+        currentPage++;
+        if (delayMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+}
+//# sourceMappingURL=pagination.js.map

package/dist/core/pagination.js.map

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

package/dist/core/schemas/album.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"album.schemas.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/album.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAsEvB;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYtB,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAErC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;iBAarC,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAcxC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BpC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAA;AAExC;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;iBAOpC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,cAAc,CAAA;AAGzD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAC/C,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAC7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAC7E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AACjF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AACnF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAC/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA"}

package/dist/{services → core/schemas}/album.schemas.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { albumNameSchema, artistNameSchema, contentSchema, countSchema, durationSchema, forSchema, imageSchema, itemsPerPageSchema, langSchema, limitSchema, listenersSchema, mbidSchema, nameSchema, pageSchema, playcountSchema, publishedSchema, roleSchema, searchTermsSchema, startIndexSchema, startPageSchema, summarySchema, tagNameSchema, textSchema, totalResultsSchema, urlSchema, userNameSchema, } from './schemas/index.js';
+import { albumNameSchema, artistNameSchema, contentSchema, countSchema, durationSchema, forSchema, imageSchema, itemsPerPageSchema, langSchema, limitSchema, listenersSchema, mbidSchema, nameSchema, pageSchema, playcountSchema, publishedSchema, roleSchema, searchTermsSchema, startIndexSchema, startPageSchema, summarySchema, tagNameSchema, textSchema, totalResultsSchema, urlSchema, userNameSchema, } from './base/index.js';
 const albumTagSchema = z.object({
     tag: z
         .union([

package/dist/core/schemas/album.schemas.js.map

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