wip & poc phase

Author: xwxfox

.bruno/AppleMusic/aaa.bru

@@ -0,0 +1,15 @@
+meta {
+  name: aaa
+  type: http
+  seq: 3
+}
+
+get {
+  url: https://amp-api-edge.music.apple.com/v1/test
+  body: none
+  auth: inherit
+}
+
+settings {
+  encodeUrl: true
+}

.bruno/AppleMusic/bruno.json

@@ -0,0 +1,9 @@
+{
+  "version": "1",
+  "name": "AppleMusic",
+  "type": "collection",
+  "ignore": [
+    "node_modules",
+    ".git"
+  ]
+}

.bruno/AppleMusic/get base js.bru

@@ -0,0 +1,15 @@
+meta {
+  name: get base js
+  type: http
+  seq: 3
+}
+
+get {
+  url: https://music.apple.com/
+  body: none
+  auth: inherit
+}
+
+settings {
+  encodeUrl: true
+}

.bruno/AppleMusic/get base.bru

@@ -0,0 +1,15 @@
+meta {
+  name: get base
+  type: http
+  seq: 1
+}
+
+get {
+  url: https://music.apple.com/
+  body: none
+  auth: inherit
+}
+
+settings {
+  encodeUrl: true
+}

bun.lock

@@ -10,7 +10,6 @@ export default [
     ignores: ['.next/**', 'node_modules/**', 'dist/**', 'coverage/**', 'scripts/**'],
   },
   // Security
-  //@ts-expect-error eslint-plugin-security has no types // not the "correct" ones at least
   securityPlugin.configs.recommended,
   {
     files: ['**/*.ts'],

eslint.config.ts

@@ -10,7 +10,8 @@
   "description": "Apple Music API",
   "scripts": {
     "build": "rm -rf ./dist && tsc --build --verbose --diagnostics && tsc-alias",
-    "test": "vitest run",
+    "test": "vitest run --coverage",
+    "dtest": "bun run src/test.ts",
     "check-types": "tsc --noEmit",
     "lint": "eslint . --ext .ts"
   },
@@ -40,12 +41,15 @@
     "applemusic"
   ],
   "dependencies": {
-    "axios": "^1.11.0"
+    "axios": "^1.11.0",
+    "tough-cookie": "^6.0.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.26.0",
     "@types/bun": "latest",
+    "@types/eslint-plugin-security": "^3.0.0",
     "@types/supertest": "^6.0.3",
+    "@vitest/coverage-v8": "3.2.4",
     "eslint": "^9.26.0",
     "eslint-plugin-security": "^3.0.1",
     "eslint-plugin-unicorn": "^61.0.2",

package.json

@@ -0,0 +1,116 @@
+---
+title: "Albums.Attributes"
+source: "https://developer.apple.com/documentation/applemusicapi/albums/attributes-data.dictionary"
+author:
+  - "[[Apple Developer Documentation]]"
+published:
+created: 2025-10-02
+description: "The attributes for an album resource."
+tags:
+  - "clippings"
+---
+[Skip Navigation](https://developer.apple.com/documentation/applemusicapi/albums/#app-main)
+
+The attributes for an album resource.
+
+```
+object Albums.Attributes
+```
+
+## Properties
+
+`artistName`
+
+(Required)
+
+The name of the primary artist associated with the album.
+
+`artistUrl`
+
+**(Extended)** The URL of the artist for this content.
+
+`artwork`
+
+(Required)
+
+The artwork for the album.
+
+`audioVariants`
+
+**(Extended)** Indicates the specific audio variant for the album.
+
+`contentRating`
+
+The Recording Industry Association of America (RIAA) rating of the content. No value means no rating.
+
+`editorialNotes`
+
+The notes about the album that appear in the iTunes Store.
+
+`genreNames`
+
+(Required)
+
+The names of the genres associated with the album.
+
+`inFavorites`
+
+`isCompilation`
+
+(Required)
+
+Indicates whether the album is marked as a compilation. If `true`, the album is a compilation; otherwise, it’s not.
+
+`isComplete`
+
+(Required)
+
+Indicates whether the album is complete. If `true`, the album is complete; otherwise, it’s not. An album is complete if it contains all its tracks and songs.
+
+`isMasteredForItunes`
+
+(Required)
+
+Indicates whether the response delivered the album as an [Apple Digital Master](https://www.apple.com/itunes/mastered-for-itunes/).
+
+`isSingle`
+
+(Required)
+
+Indicates whether the album contains a single song.
+
+`name`
+
+(Required)
+
+The localized name of the album.
+
+`playParams`
+
+When present, this attribute indicates that one or more tracks on the album are available to play with an Apple Music subscription. The value map may be used to initiate playback of available tracks on the album.
+
+`recordLabel`
+
+The name of the record label for the album.
+
+`releaseDate`
+
+The release date of the album, when known, in YYYY-MM-DD or YYYY format. Prerelease content may have an expected release date in the future.
+
+`trackCount`
+
+(Required)
+
+The number of tracks for the album.
+
+`upc`
+
+The Universal Product Code for the album.
+
+`url`
+
+(Required)
+
+The URL for sharing the album in Apple Music.
+
+Current page is Albums.Attributes

research/AppleAPIDocs/Albums/Albums.Attributes.md

@@ -0,0 +1,49 @@
+---
+title: "Albums.Relationships.AlbumsArtistsRelationship"
+source: "https://developer.apple.com/documentation/applemusicapi/albums/relationships-data.dictionary/albumsartistsrelationship"
+author:
+  - "[[Apple Developer Documentation]]"
+published:
+created: 2025-10-02
+description: "A relationship from the album to its artists."
+tags:
+  - "clippings"
+---
+[Skip Navigation](https://developer.apple.com/documentation/applemusicapi/albums/relationships-data.dictionary/#app-main)
+
+- [Apple Music API](https://developer.apple.com/documentation/applemusicapi)
+- [Albums](https://developer.apple.com/documentation/applemusicapi/albums)
+- [Albums.Relationships](https://developer.apple.com/documentation/applemusicapi/albums/relationships-data.dictionary)
+- Albums.Relationships.AlbumsArtistsRelationship
+
+Object
+
+A relationship from the album to its artists.
+
+```
+object Albums.Relationships.AlbumsArtistsRelationship
+```
+
+## Properties
+
+`href`
+
+`string`
+
+The relative location to fetch the relationship directly.
+
+`next`
+
+`string`
+
+The relative location to request the next page of resources in the collection, if additional resources are available for fetching.
+
+`data`
+
+``[[`Artists`](https://developer.apple.com/documentation/applemusicapi/artists)]``
+
+(Required)
+
+The artists for the album.
+
+Current page is Albums.Relationships.AlbumsArtistsRelationship

research/AppleAPIDocs/Albums/Albums.Relationships.AlbumsArtistsRelationship.md

@@ -0,0 +1,49 @@
+---
+title: "Albums.Relationships.AlbumsGenresRelationship"
+source: "https://developer.apple.com/documentation/applemusicapi/albums/relationships-data.dictionary/albumsgenresrelationship"
+author:
+  - "[[Apple Developer Documentation]]"
+published:
+created: 2025-10-02
+description: "A relationship from the album to its genres."
+tags:
+  - "clippings"
+---
+[Skip Navigation](https://developer.apple.com/documentation/applemusicapi/albums/relationships-data.dictionary/#app-main)
+
+- [Apple Music API](https://developer.apple.com/documentation/applemusicapi)
+- [Albums](https://developer.apple.com/documentation/applemusicapi/albums)
+- [Albums.Relationships](https://developer.apple.com/documentation/applemusicapi/albums/relationships-data.dictionary)
+- Albums.Relationships.AlbumsGenresRelationship
+
+Object
+
+A relationship from the album to its genres.
+
+```
+object Albums.Relationships.AlbumsGenresRelationship
+```
+
+## Properties
+
+`href`
+
+`string`
+
+The relative location to fetch the relationship directly.
+
+`next`
+
+`string`
+
+The relative location to request the next page of resources in the collection, if additional resources are available for fetching.
+
+`data`
+
+``[[`Genres`](https://developer.apple.com/documentation/applemusicapi/genres)]``
+
+(Required)
+
+The album’s associated genre.
+
+Current page is Albums.Relationships.AlbumsGenresRelationship