@tidal-music/api 0.31.0 → 0.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5550,6 +5550,174 @@ export interface paths {
5550
5550
  patch?: never;
5551
5551
  trace?: never;
5552
5552
  };
5553
+ "/dynamicModules": {
5554
+ parameters: {
5555
+ query?: never;
5556
+ header?: never;
5557
+ path?: never;
5558
+ cookie?: never;
5559
+ };
5560
+ /**
5561
+ * Get multiple dynamicModules.
5562
+ * @description Retrieves multiple dynamicModules by available filters, or without if applicable.
5563
+ */
5564
+ get: {
5565
+ parameters: {
5566
+ query: {
5567
+ /** @description Stable seed used to keep dynamic page and module results consistent across a client session. */
5568
+ refreshSeed?: string;
5569
+ /**
5570
+ * @description ISO 3166-1 alpha-2 country code
5571
+ * @example US
5572
+ */
5573
+ countryCode?: string;
5574
+ /**
5575
+ * @description BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported.
5576
+ * @example en-US
5577
+ */
5578
+ locale?: string;
5579
+ /**
5580
+ * @description The type of device making the request
5581
+ * @example PHONE
5582
+ */
5583
+ deviceType: "BROWSER" | "CAR" | "DESKTOP" | "PHONE" | "TABLET" | "TV";
5584
+ /**
5585
+ * @description The system type of the device making the request
5586
+ * @example IOS
5587
+ */
5588
+ systemType: "ANDROID" | "DESKTOP" | "TESLA" | "IOS" | "WEB";
5589
+ /**
5590
+ * @description Client version number
5591
+ * @example 2026.0.1
5592
+ */
5593
+ clientVersion: string;
5594
+ /**
5595
+ * @description Allows the client to customize which related resources should be returned. Available options: items
5596
+ * @example items
5597
+ */
5598
+ include?: string[];
5599
+ /** @description DynamicModules Id (e.g. `nejMcAhh5N8S3EQ4LaqysVdI0cZZ`) */
5600
+ "filter[id]": string[];
5601
+ };
5602
+ header?: never;
5603
+ path?: never;
5604
+ cookie?: never;
5605
+ };
5606
+ requestBody?: never;
5607
+ responses: {
5608
+ /** @description Successful response */
5609
+ 200: {
5610
+ headers: {
5611
+ [name: string]: unknown;
5612
+ };
5613
+ content: {
5614
+ "application/vnd.api+json": components["schemas"]["DynamicModules_Multi_Resource_Data_Document"];
5615
+ };
5616
+ };
5617
+ 400: components["responses"]["Default400Response"];
5618
+ 404: components["responses"]["Default404Response"];
5619
+ 405: components["responses"]["Default405Response"];
5620
+ 406: components["responses"]["Default406Response"];
5621
+ 415: components["responses"]["Default415Response"];
5622
+ 429: components["responses"]["Default429Response"];
5623
+ 500: components["responses"]["Default500Response"];
5624
+ 503: components["responses"]["Default503Response"];
5625
+ };
5626
+ };
5627
+ put?: never;
5628
+ post?: never;
5629
+ delete?: never;
5630
+ options?: never;
5631
+ head?: never;
5632
+ patch?: never;
5633
+ trace?: never;
5634
+ };
5635
+ "/dynamicModules/{id}": {
5636
+ parameters: {
5637
+ query?: never;
5638
+ header?: never;
5639
+ path?: never;
5640
+ cookie?: never;
5641
+ };
5642
+ /**
5643
+ * Get single dynamicModule.
5644
+ * @description Retrieves single dynamicModule by id.
5645
+ */
5646
+ get: {
5647
+ parameters: {
5648
+ query: {
5649
+ /** @description Stable seed used to keep dynamic page and module results consistent across a client session. */
5650
+ refreshSeed?: string;
5651
+ /**
5652
+ * @description ISO 3166-1 alpha-2 country code
5653
+ * @example US
5654
+ */
5655
+ countryCode?: string;
5656
+ /**
5657
+ * @description BCP 47 locale (e.g., en-US, nb-NO, pt-BR). Defaults to en-US if not provided or unsupported.
5658
+ * @example en-US
5659
+ */
5660
+ locale?: string;
5661
+ /**
5662
+ * @description The type of device making the request
5663
+ * @example PHONE
5664
+ */
5665
+ deviceType: "BROWSER" | "CAR" | "DESKTOP" | "PHONE" | "TABLET" | "TV";
5666
+ /**
5667
+ * @description The system type of the device making the request
5668
+ * @example IOS
5669
+ */
5670
+ systemType: "ANDROID" | "DESKTOP" | "TESLA" | "IOS" | "WEB";
5671
+ /**
5672
+ * @description Client version number
5673
+ * @example 2026.0.1
5674
+ */
5675
+ clientVersion: string;
5676
+ /**
5677
+ * @description Allows the client to customize which related resources should be returned. Available options: items
5678
+ * @example items
5679
+ */
5680
+ include?: string[];
5681
+ };
5682
+ header?: never;
5683
+ path: {
5684
+ /**
5685
+ * @description DynamicModules Id
5686
+ * @example nejMcAhh5N8S3EQ4LaqysVdI0cZZ
5687
+ */
5688
+ id: string;
5689
+ };
5690
+ cookie?: never;
5691
+ };
5692
+ requestBody?: never;
5693
+ responses: {
5694
+ /** @description Successful response */
5695
+ 200: {
5696
+ headers: {
5697
+ [name: string]: unknown;
5698
+ };
5699
+ content: {
5700
+ "application/vnd.api+json": components["schemas"]["DynamicModules_Single_Resource_Data_Document"];
5701
+ };
5702
+ };
5703
+ 400: components["responses"]["Default400Response"];
5704
+ 404: components["responses"]["Default404Response"];
5705
+ 405: components["responses"]["Default405Response"];
5706
+ 406: components["responses"]["Default406Response"];
5707
+ 415: components["responses"]["Default415Response"];
5708
+ 429: components["responses"]["Default429Response"];
5709
+ 500: components["responses"]["Default500Response"];
5710
+ 503: components["responses"]["Default503Response"];
5711
+ };
5712
+ };
5713
+ put?: never;
5714
+ post?: never;
5715
+ delete?: never;
5716
+ options?: never;
5717
+ head?: never;
5718
+ patch?: never;
5719
+ trace?: never;
5720
+ };
5553
5721
  "/dynamicModules/{id}/relationships/items": {
5554
5722
  parameters: {
5555
5723
  query?: never;
@@ -5564,7 +5732,8 @@ export interface paths {
5564
5732
  get: {
5565
5733
  parameters: {
5566
5734
  query: {
5567
- refreshId?: string;
5735
+ /** @description Stable seed used to keep dynamic page and module results consistent across a client session. */
5736
+ refreshSeed?: string;
5568
5737
  /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
5569
5738
  "page[cursor]"?: string;
5570
5739
  /**
@@ -5651,7 +5820,8 @@ export interface paths {
5651
5820
  get: {
5652
5821
  parameters: {
5653
5822
  query: {
5654
- refreshId?: string;
5823
+ /** @description Stable seed used to keep dynamic page and module results consistent across a client session. */
5824
+ refreshSeed?: string;
5655
5825
  /**
5656
5826
  * @description ISO 3166-1 alpha-2 country code
5657
5827
  * @example US
@@ -5678,8 +5848,8 @@ export interface paths {
5678
5848
  */
5679
5849
  clientVersion: string;
5680
5850
  /**
5681
- * @description Allows the client to customize which related resources should be returned. Available options: dynamicModules, subject
5682
- * @example dynamicModules
5851
+ * @description Allows the client to customize which related resources should be returned. Available options: modules, subject
5852
+ * @example modules
5683
5853
  */
5684
5854
  include?: string[];
5685
5855
  /** @description type of the page (e.g. `ARTIST`) */
@@ -5720,7 +5890,7 @@ export interface paths {
5720
5890
  patch?: never;
5721
5891
  trace?: never;
5722
5892
  };
5723
- "/dynamicPages/{id}/relationships/dynamicModules": {
5893
+ "/dynamicPages/{id}/relationships/modules": {
5724
5894
  parameters: {
5725
5895
  query?: never;
5726
5896
  header?: never;
@@ -5728,13 +5898,14 @@ export interface paths {
5728
5898
  cookie?: never;
5729
5899
  };
5730
5900
  /**
5731
- * Get dynamicModules relationship ("to-many").
5732
- * @description Retrieves dynamicModules relationship.
5901
+ * Get modules relationship ("to-many").
5902
+ * @description Retrieves modules relationship.
5733
5903
  */
5734
5904
  get: {
5735
5905
  parameters: {
5736
5906
  query: {
5737
- refreshId?: string;
5907
+ /** @description Stable seed used to keep dynamic page and module results consistent across a client session. */
5908
+ refreshSeed?: string;
5738
5909
  /** @description Server-generated cursor value pointing a certain page of items. Optional, targets first page if not specified */
5739
5910
  "page[cursor]"?: string;
5740
5911
  /**
@@ -5763,8 +5934,8 @@ export interface paths {
5763
5934
  */
5764
5935
  clientVersion: string;
5765
5936
  /**
5766
- * @description Allows the client to customize which related resources should be returned. Available options: dynamicModules
5767
- * @example dynamicModules
5937
+ * @description Allows the client to customize which related resources should be returned. Available options: modules
5938
+ * @example modules
5768
5939
  */
5769
5940
  include?: string[];
5770
5941
  };
@@ -20375,27 +20546,15 @@ export interface components {
20375
20546
  DynamicModules_Attributes: {
20376
20547
  /**
20377
20548
  * @description Type of icons the module should show
20378
- * @example SPOTLIGHT_ICON
20549
+ * @example SPOTLIGHT_INFO
20379
20550
  */
20380
20551
  icons: ("SPOTLIGHT_INFO" | "UNKNOWN")[];
20381
20552
  /**
20382
- * @description Type of representation of the items in the module view all screen
20383
- * @example COMPACT
20384
- * @enum {string}
20385
- */
20386
- layoutType: "COMPACT" | "GRID" | "UNKNOWN";
20387
- /**
20388
- * @description Type of representation of the module
20553
+ * @description Layout of the module preview on the dynamic page
20389
20554
  * @example HORIZONTAL_LIST
20390
20555
  * @enum {string}
20391
20556
  */
20392
- moduleType: "ARTIST_LIST" | "COMPACT_GRID_CARD" | "COMPACT_HORIZONTAL_LIST" | "COMPACT_HORIZONTAL_LIST_WITH_CONTEXT" | "FEATURED_CARD" | "GRID_CARD" | "GRID_CARD_WITH_CONTEXT" | "GRID_HIGHLIGHT_CARD" | "ANNIVERSARY_CARD" | "ARTIST_BIRTHDAY_CARD" | "ARTIST_MEMORIAM_CARD" | "ARTIST_TRACK_CREDITS_CARD" | "PILL_LIST" | "VERTICAL_LIST" | "DISCOGRAPHY_TABS" | "MAGAZINE_LIST" | "HORIZONTAL_LIST" | "HORIZONTAL_LIST_WITH_CONTEXT" | "SHORTCUT_LIST" | "TRACK_LIST" | "VERTICAL_LIST_CARD" | "TEXT_CARD" | "LINKS_LIST" | "PUBLIC_PLAYLIST_LIST";
20393
- /**
20394
- * @description Type of source represented by the module
20395
- * @example SHORTCUTS
20396
- * @enum {string}
20397
- */
20398
- sourceType: "ALBUM_RECOMMENDATIONS" | "BECAUSE_YOU_LISTENED_TO_ALBUM" | "BECAUSE_YOU_ADDED_ALBUM" | "BECAUSE_YOU_ADDED_ARTIST" | "CONTINUE_LISTEN_TO" | "DAILY_MIXES" | "FORGOTTEN_FAVORITES" | "GENRE_MIXES" | "HISTORY_MIXES" | "LOCAL_PLAYLISTS" | "MY_PLAYLISTS" | "NEW_ALBUM_SUGGESTIONS" | "NEW_TRACK_SUGGESTIONS" | "NEW_ALBUMS" | "NEW_TRACKS" | "POPULAR_PLAYLISTS" | "RECENTLY_UPDATED_FAVORITED_PLAYLIST" | "RECOMMENDED_USERS_PLAYLISTS" | "SUGGESTED_ESSENTIAL_PLAYLISTS" | "SUGGESTED_RADIOS_MIXES" | "WELCOME_MIX" | "YOUR_FAVORITE_ARTISTS" | "UPLOADS_FOR_YOU" | "LATEST_SPOTLIGHTED_TRACKS" | "SHORTCUTS" | "ARTIST_TOP_TRACKS" | "ARTIST_SPOTLIGHTED_TRACKS" | "ARTIST_ALBUMS" | "ARTIST_TOP_SINGLES" | "ARTIST_COMPILATIONS" | "ARTIST_LIVE_ALBUMS" | "ARTIST_APPEARS_ON" | "ARTIST_PLAYLIST" | "ARTIST_PUBLIC_PLAYLIST" | "ARTIST_SIMILAR_ARTISTS" | "ARTIST_TRACK_UPLOADS" | "ARTIST_LINKS" | "ARTIST_VIDEOS" | "ARTIST_CREDITS" | "ARTIST_DISCOGRAPHY" | "ALBUM_ITEMS" | "ALBUM_MORE_BY_ARTIST" | "ALBUM_OTHER_VERSIONS" | "ALBUM_RELATED_ALBUMS" | "ALBUM_RELATED_ARTISTS" | "COLLECTION_ITEMS" | "ALBUM_ANNIVERSARY" | "ARTIST_BIRTHDAY" | "ARTIST_MEMORIAM" | "DJ_TOOLS" | "DJ_ARTIST_CURATED" | "THE_HITS" | "FROM_OUR_EDITORS" | "TOP_PLAYLISTS" | "FEATURED_TOP_TRACKS" | "FEATURED_TOP_ALBUMS" | "TOP_ARTISTS_ESSENTIALS" | "FEATURED_RECOMMENDED_PLAYLISTS" | "HOME_3_FEATURED_PLAYLISTS" | "HOME_3_FEATURED_UPLOAD_TRACKS" | "HOME_3_FEATURED_ALBUMS" | "POPULAR_ALBUMS" | "POPULAR_ARTISTS" | "POPULAR_MIXES" | "FEATURED_RECOMMENDED_TRACKS" | "FEATURED_RECOMMENDED_ALBUMS" | "FEATURED_RECOMMENDED_CLASSIC_ALBUMS" | "BACK_TO_SCHOOL_MUSIC_101" | "BACK_TO_SCHOOL_GENRES_FOR_BEGINNERS" | "HEADLINERS_2026" | "HOME_3_0_GENERIC_PLAYLISTS_1" | "HOME_3_0_GENERIC_PLAYLISTS_2" | "HOME_3_0_GENERIC_ALBUMS_1" | "HOME_3_0_GENERIC_TRACKS_1" | "HOME_3_0_GENERIC_ARTISTS_1" | "HOME_3_0_GENERIC_VIDEOS_1" | "STAFF_PICKS_PAGE_ALBUMS_WE_LOVE" | "STAFF_PICKS_PAGE_EXPLORE" | "STAFF_PICKS_PAGE_FAVORITE_SONGS" | "STAFF_PICKS_PAGE_RECENTLY_UPDATED_PLAYLISTS" | "STAFF_PICKS_PAGE_TIDAL_NEWS_MAGAZINE" | "STAFF_PICKS_PAGE_WHAT_LISTENING_TO" | "BASED_ON_YOUR_INTERESTS_1" | "BASED_ON_YOUR_INTERESTS_2" | "UPLOAD_PAGE_SPOTLIGHTED_PLAYLISTS" | "UPLOAD_PAGE_PAYGATED_ALBUMS" | "UPLOAD_PAGE_ALBUMS" | "TOP_UPLOADERS" | "UPLOAD_PAGE_ARTISTS" | "UPLOAD_PAGE_FEATURED_MAGAZINE" | "EXPLORE_DECADES" | "EXPLORE_GENRES" | "EXPLORE_MOODS" | "ARTIST_POPULAR_RELEASES" | "PURCHASES_FOR_YOU" | "UNKNOWN";
20557
+ previewLayout: "ARTIST_LIST" | "COMPACT_GRID_CARD" | "COMPACT_HORIZONTAL_LIST" | "COMPACT_HORIZONTAL_LIST_WITH_CONTEXT" | "FEATURED_CARD" | "GRID_CARD" | "GRID_CARD_WITH_CONTEXT" | "GRID_HIGHLIGHT_CARD" | "ANNIVERSARY_CARD" | "ARTIST_BIRTHDAY_CARD" | "ARTIST_MEMORIAM_CARD" | "ARTIST_TRACK_CREDITS_CARD" | "PILL_LIST" | "VERTICAL_LIST" | "DISCOGRAPHY_TABS" | "MAGAZINE_LIST" | "HORIZONTAL_LIST" | "HORIZONTAL_LIST_WITH_CONTEXT" | "SHORTCUT_LIST" | "TRACK_LIST" | "VERTICAL_LIST_CARD" | "TEXT_CARD" | "LINKS_LIST" | "PUBLIC_PLAYLIST_LIST";
20399
20558
  /**
20400
20559
  * @description Subtitle of the module
20401
20560
  * @example Short description of this module
@@ -20406,6 +20565,12 @@ export interface components {
20406
20565
  * @example Shortcuts
20407
20566
  */
20408
20567
  title?: string;
20568
+ /**
20569
+ * @description Layout of the module's items in the view all screen
20570
+ * @example COMPACT
20571
+ * @enum {string}
20572
+ */
20573
+ viewAllLayout: "COMPACT" | "GRID" | "UNKNOWN";
20409
20574
  };
20410
20575
  DynamicModules_Multi_Relationship_Data_Document: {
20411
20576
  data?: components["schemas"]["Resource_Identifier"][];
@@ -20464,7 +20629,7 @@ export interface components {
20464
20629
  links: components["schemas"]["Links"];
20465
20630
  };
20466
20631
  DynamicPages_Relationships: {
20467
- dynamicModules?: components["schemas"]["Multi_Relationship_Data_Document"];
20632
+ modules?: components["schemas"]["Multi_Relationship_Data_Document"];
20468
20633
  subject?: components["schemas"]["Single_Relationship_Data_Document"];
20469
20634
  };
20470
20635
  DynamicPages_Resource_Object: {
@@ -20474,6 +20639,7 @@ export interface components {
20474
20639
  * @example 12345
20475
20640
  */
20476
20641
  id: string;
20642
+ meta?: components["schemas"]["DynamicPages_Resource_Object_Meta"];
20477
20643
  relationships?: components["schemas"]["DynamicPages_Relationships"];
20478
20644
  /**
20479
20645
  * @description Resource type (enum property replaced by openapi-typescript)
@@ -20481,6 +20647,13 @@ export interface components {
20481
20647
  */
20482
20648
  type: "dynamicPages";
20483
20649
  };
20650
+ DynamicPages_Resource_Object_Meta: {
20651
+ /**
20652
+ * @description Reason why data has been redacted on this page
20653
+ * @enum {string}
20654
+ */
20655
+ redactionReason?: "NO_BIRTHDAY" | "MINOR";
20656
+ };
20484
20657
  DynamicPages_Single_Relationship_Data_Document: {
20485
20658
  data?: components["schemas"]["Resource_Identifier"];
20486
20659
  included?: components["schemas"]["Included"];
@@ -22358,12 +22531,16 @@ export interface components {
22358
22531
  * @example 12345
22359
22532
  */
22360
22533
  id: string;
22534
+ meta?: components["schemas"]["Terms_Resource_Object_Meta"];
22361
22535
  /**
22362
22536
  * @description Resource type (enum property replaced by openapi-typescript)
22363
22537
  * @enum {string}
22364
22538
  */
22365
22539
  type: "terms";
22366
22540
  };
22541
+ Terms_Resource_Object_Meta: {
22542
+ isLatestVersion: boolean;
22543
+ };
22367
22544
  Terms_Single_Resource_Data_Document: {
22368
22545
  data: components["schemas"]["Terms_Resource_Object"];
22369
22546
  included?: components["schemas"]["Included"];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tidal-music/api",
3
- "version": "0.31.0",
3
+ "version": "0.33.0",
4
4
  "type": "module",
5
5
  "files": [
6
6
  "dist"
@@ -28,8 +28,8 @@
28
28
  "vite": "8.0.16",
29
29
  "vite-plugin-dts": "5.0.2",
30
30
  "vitest": "4.1.8",
31
- "@tidal-music/auth": "^1.6.1",
32
- "@tidal-music/common": "^0.2.1"
31
+ "@tidal-music/common": "^0.2.1",
32
+ "@tidal-music/auth": "^1.6.1"
33
33
  },
34
34
  "scripts": {
35
35
  "build": "vite build",