musicbrainz-api 0.7.0 → 0.8.0

package/lib/musicbrainz.types.d.ts

@@ -1,17 +1,20 @@
 import DateTimeFormat = Intl.DateTimeFormat;
+import { IFormData, Includes } from './musicbrainz-api';
 export interface IPeriod {
     'begin': string;
     'ended': boolean;
     'end': string;
 }
-export interface IArea {
+export interface IEntity {
     id: string;
+}
+export interface IArea extends IEntity {
     'iso-3166-1-codes': string[];
     name: string;
     'sort-name': string;
     disambiguation: string;
 }
-export interface IAlias {
+export interface IAlias extends IEntity {
     name: string;
     'sort-name': string;
     ended: boolean;
@@ -25,8 +28,7 @@ export interface IAlias {
 export interface IMatch {
     score: number;
 }
-export interface IArtist {
-    id: string;
+export interface IArtist extends IEntity {
     name: string;
     disambiguation: string;
     'sort-name': string;
@@ -54,9 +56,25 @@ export interface IArtistCredit {
     joinphrase: string;
     name: string;
 }
+export interface IEvent extends IEntity {
+    cancelled: boolean;
+    type: string;
+    'life-span': IPeriod;
+    disambiguation: string;
+    'type-id': string;
+    time: string;
+    setlist: string;
+    name: string;
+}
+export interface IInstrument extends IEntity {
+    disambiguation: string;
+    name: string;
+    'type-id': string;
+    type: string;
+    description: string;
+}
 export declare type ReleaseQuality = 'normal';
-export interface IRelease {
-    id: string;
+export interface IRelease extends IEntity {
     title: string;
     'text-representation': {
         'language': string;
@@ -84,23 +102,21 @@ export interface IReleaseEvent {
     date?: string;
 }
 export declare type MediaFormatType = 'Digital Media';
-export interface IRecording {
-    id: string;
+export interface IRecording extends IEntity {
     video: boolean;
     length: number;
     title: string;
     disambiguation: string;
     isrcs?: string[];
-    releases?: IRelease;
+    releases?: IRelease[];
     relations?: IRelation[];
     'artist-credit'?: IArtistCredit[];
     aliases?: IAlias[];
 }
-export interface ITrack {
-    id: string;
+export interface ITrack extends IEntity {
     position: number;
     recording: IRecording;
-    number: string;
+    'number': string;
     length: number;
     title: string;
     'artist-credit'?: IArtistCredit[];
@@ -109,10 +125,10 @@ export interface IMedium {
     title: string;
     format?: string;
     'format-id': string;
-    'tracks': ITrack[];
+    tracks: ITrack[];
     'track-count': number;
     'track-offset': number;
-    'position': number;
+    position: number;
 }
 export interface ICoverArtArchive {
     count: number;
@@ -121,15 +137,16 @@ export interface ICoverArtArchive {
     artwork: boolean;
     back: boolean;
 }
-export interface IReleaseGroup {
-    id: string;
+export interface IReleaseGroup extends IEntity {
     count: number;
     title: string;
     'primary-type': string;
     'sort-name': string;
-    'artist-credit': [{
+    'artist-credit': {
         artist: IArtist;
-    }];
+        name: string;
+        joinphrase: string;
+    }[];
     releases?: IRelease[];
 }
 export interface IArtistMatch extends IArtist, IMatch {
@@ -162,7 +179,7 @@ export interface IUrlList extends ISearchResult {
 }
 export declare type RelationDirection = 'backward' | 'forward';
 export interface IRelation {
-    'attribute-ids': {};
+    'attribute-ids': any;
     direction: RelationDirection;
     'target-credit': string;
     end: null | object;
@@ -174,35 +191,32 @@ export interface IRelation {
     begin?: null | object;
     'target-type'?: 'url';
     'type-id': string;
-    url?: IURL;
+    url?: IUrl;
     release?: IRelease;
 }
-export interface IURL {
-    id: string;
-    resource: string;
-}
 export interface IRelationList {
     relations: IRelation[];
 }
-export interface IWork {
-    id: string;
+export interface IWork extends IEntity {
     title: string;
 }
-export interface ILabel {
-    id: string;
+export interface ILabel extends IEntity {
+    name: string;
+}
+export interface IPlace extends IEntity {
     name: string;
 }
-export interface IUrl {
+export interface IUrl extends IEntity {
     id: string;
     resource: string;
-    'relation-list': IRelationList[];
+    'relation-list'?: IRelationList[];
 }
 export interface IUrlMatch extends IMatch, IUrl {
 }
 export interface IUrlSearchResult extends ISearchResult {
     urls?: IUrlMatch[];
 }
-export interface IIsrcSearchResult {
+export interface IIsrcSearchResult extends ISearchResult {
     'isrc': string;
     'recordings': IRecording[];
 }
@@ -249,5 +263,130 @@ export interface ISearchQuery extends IPagination {
     /**
      * Lucene search query, this is mandatory
      */
-    query: string;
+    query?: string | IFormData;
+    inc?: Includes[];
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Browse
+ * /ws/2/area              collection
+ */
+export interface ILinkedEntitiesArea {
+    collection?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Browse
+ * /ws/2/artist            area, collection, recording, release, release-group, work
+ */
+export interface ILinkedEntitiesArtist {
+    area?: string;
+    collection?: string;
+    recording?: string;
+    release?: string;
+    'release-group'?: string;
+    work?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Browse
+ * /ws/2/collection        area, artist, editor, event, label, place, recording, release, release-group, work
+ */
+export interface ILinkedEntitiesCollection {
+    area?: string;
+    artist?: string;
+    editor?: string;
+    event?: string;
+    label?: string;
+    place?: string;
+    recording?: string;
+    release?: string;
+    'release-group'?: string;
+    work?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/event             area, artist, collection, place
+ */
+export interface ILinkedEntitiesEvent {
+    area?: string;
+    artist?: string;
+    collection?: string;
+    place?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/instrument        collection
+ */
+export interface ILinkedEntitiesInstrument {
+    collection?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/label             area, collection, release
+ */
+export interface ILinkedEntitiesLabel {
+    area?: string;
+    collection?: string;
+    release?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/place             area, collection
+ */
+export interface IBrowseArgumentPlace {
+    area?: string;
+    collection?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/recording         artist, collection, release, work
+ */
+export interface ILinkedEntitiesRecording {
+    area?: string;
+    collection?: string;
+    release?: string;
+    work?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/release           area, artist, collection, label, track, track_artist, recording, release-group
+ */
+export interface ILinkedEntitiesRelease {
+    area?: string;
+    artist?: string;
+    collection?: string;
+    label?: string;
+    track?: string;
+    track_artist?: string;
+    recording?: string;
+    'release-group'?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/release-group     artist, collection, release
+ */
+export interface ILinkedEntitiesReleaseGroup {
+    artist?: string;
+    collection?: string;
+    release?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Subqueries
+ * /ws/2/series            collection
+ */
+export interface ILinkedEntitiesSeries {
+    collection?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Browse
+ * /ws/2/work              artist, collection
+ */
+export interface ILinkedEntitiesWork {
+    artist?: string;
+    collection?: string;
+}
+/**
+ * https://musicbrainz.org/doc/MusicBrainz_API#Browse
+ * /ws/2/url               resource
+ */
+export interface ILinkedEntitiesUrl {
+    resource?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musicbrainz-api",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MusicBrainz API client for reading and submitting metadata",
   "main": "lib/musicbrainz-api",
   "types": "lib/musicbrainz-api",
@@ -24,21 +24,6 @@
   ],
   "license": "MIT",
   "private": false,
-  "devDependencies": {
-    "@types/chai": "^4.2.5",
-    "@types/mocha": "^9.0.0",
-    "@types/node": "^17.0.8",
-    "chai": "^4.2.0",
-    "coveralls": "^3.0.9",
-    "del-cli": "^4.0.1",
-    "mocha": "^9.0.1",
-    "nyc": "^15.0.0",
-    "remark-cli": "^10.0.1",
-    "remark-preset-lint-recommended": "^6.1.2",
-    "ts-node": "^10.0.0",
-    "tslint": "^6.1.1",
-    "typescript": "^4.0.2"
-  },
   "engines": {
     "node": "*"
   },
@@ -63,14 +48,38 @@
     "tough-cookie": "^4.0.0",
     "uuid": "^8.3.2"
   },
+  "devDependencies": {
+    "@types/chai": "^4.3.0",
+    "@types/mocha": "^9.0.0",
+    "@types/node": "^17.0.8",
+    "@typescript-eslint/eslint-plugin": "^5.13.0",
+    "@typescript-eslint/parser": "^5.13.0",
+    "chai": "^4.2.0",
+    "coveralls": "^3.0.9",
+    "del-cli": "^4.0.1",
+    "eslint": "^8.10.0",
+    "eslint-config-prettier": "^8.4.0",
+    "eslint-import-resolver-typescript": "^2.5.0",
+    "eslint-plugin-import": "^2.25.4",
+    "eslint-plugin-jsdoc": "^37.9.5",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-unicorn": "^41.0.0",
+    "mocha": "^9.0.1",
+    "nyc": "^15.0.0",
+    "remark-cli": "^10.0.1",
+    "remark-preset-lint-recommended": "^6.1.2",
+    "ts-node": "^10.0.0",
+    "tslint": "^6.1.1",
+    "typescript": "^4.0.2"
+  },
   "scripts": {
-    "clean": "del-cli lib/** src/**/*.js src/**/*.js.map src/**/*.d.ts test/**/*.js test/**/*.js.map",
+    "clean": "del-cli src/**/*.js src/**/*.js.map src/**/*.d.ts test/**/*.js test/**/*.js.map",
     "compile-src": "tsc -p src",
     "compile-test": "tsc -p test",
     "compile": "npm run compile-src && npm run compile-test",
-    "lint-ts": "tslint 'src/**/*.ts' --exclude 'src/**/*.d.ts' 'test/**/*.ts' --exclude 'test/**/*.d.ts'",
+    "eslint": "eslint src/**/*.ts --ignore-pattern src/**/*.d.ts test/**/*.ts",
     "lint-md": "remark -u preset-lint-recommended .",
-    "lint": "npm run lint-md && npm run lint-ts",
+    "lint": "npm run lint-md && npm run eslint",
     "test": "mocha --require ts-node/register --require source-map-support/register --full-trace test/test-*.ts",
     "build": "npm run clean && npm run compile",
     "start": "npm-run-all compile lint cover-test",
@@ -80,7 +89,6 @@
   },
   "nyc": {
     "exclude": [
-      "lib/**",
       "test/**/*.ts",
       "src/**/*.js"
     ],

package/.idea/shelf/Uncommitted_changes_before_Update_at_6-1-2022_11_38_[Default_Changelist]/shelved.patch

@@ -1,58 +0,0 @@
-Index: test/test-musicbrainz-api.ts
-IDEA additional info:
-Subsystem: com.intellij.openapi.diff.impl.patch.BaseRevisionTextPatchEP
-<+>import { IMusicBrainzConfig, LinkType, MusicBrainzApi } from '../src/musicbrainz-api';\r\nimport { assert } from 'chai';\r\nimport { XmlMetadata } from '../src/xml/xml-metadata';\r\nimport * as mb from '../src/musicbrainz.types';\r\nimport * as fs from 'fs';\r\nimport * as path from 'path';\r\n\r\nconst packageInfo = require('../package.json');\r\n\r\nconst appUrl = 'https://github.com/Borewit/musicbrainz-api';\r\n\r\nconst testBotAccount = {\r\n  username: process.env.MBUSER,\r\n  password: process.env.MBPWD\r\n};\r\n\r\nconst testApiConfig: IMusicBrainzConfig = {\r\n  botAccount: testBotAccount,\r\n  baseUrl: 'https://test.musicbrainz.org',\r\n\r\n  /**\r\n   * Enable proxy, like Fiddler\r\n   */\r\n  proxy: process.env.MBPROXY,\r\n\r\n  appName: packageInfo.name,\r\n  appVersion: packageInfo.version,\r\n  appContactInfo: appUrl\r\n};\r\n\r\nconst searchApiConfig: IMusicBrainzConfig = {\r\n\r\n  baseUrl: 'https://musicbrainz.org',\r\n\r\n  /**\r\n   * Enable proxy, like Fiddler\r\n   */\r\n  proxy: process.env.MBPROXY,\r\n\r\n  appName: packageInfo.name,\r\n  appVersion: packageInfo.version,\r\n  appContactInfo: appUrl\r\n};\r\n\r\nconst mbTestApi = new MusicBrainzApi(testApiConfig);\r\nconst mbApi = new MusicBrainzApi(searchApiConfig);\r\n\r\n// Hack shared rate-limiter\r\n(mbApi as any).rateLimiter = (mbTestApi as any).rateLimiter;\r\n\r\ndescribe('MusicBrainz-api', function() {\r\n\r\n  this.timeout(20000); // MusicBrainz has a rate limiter\r\n\r\n  const mbid = {\r\n    artist: {\r\n      Stromae: 'ab2528d9-719f-4261-8098-21849222a0f2'\r\n    },\r\n    recording: {\r\n      Formidable: '16afa384-174e-435e-bfa3-5591accda31c',\r\n      Montilla: '2faab3ff-1b3a-4378-bfa2-0513446644ed'\r\n    },\r\n    release: {\r\n      Formidable: '976e0677-a480-4a5e-a177-6a86c1900bbf',\r\n      Anomalie: '478aaba4-9425-4a67-8951-a77739462df4',\r\n      RacineCarree: [\r\n        '348662a8-54ce-4d14-adf5-3ce2cefd57bb',\r\n        'c22bdb3a-69c0-449a-9ef5-99796bb0f2d7',\r\n        'de57c1d9-5e65-420f-a896-1332e87d4c09'\r\n      ]\r\n    },\r\n    releaseGroup: {\r\n      Formidable: '19099ea5-3600-4154-b482-2ec68815883e',\r\n      RacineCarree: 'd079dc50-fa9b-4a88-90f4-5e8723accd75'\r\n    },\r\n    work: {\r\n      Formidable: 'b2aa02f4-6c95-43be-a426-aedb9f9a3805'\r\n    },\r\n    area: {\r\n      Belgium: '5b8a5ee5-0bb3-34cf-9a75-c27c44e341fc',\r\n      IleDeFrance: 'd79e4501-8cba-431b-96e7-bb9976f0ae76'\r\n    },\r\n    label: {\r\n      Mosaert: '0550200c-22c1-4c62-b761-ef0b3665262b'\r\n    }\r\n  };\r\n\r\n  const spotify = {\r\n    album: {\r\n      RacineCarree: {\r\n        id: '6uyslsVGFsHKzdGUosFwBM'\r\n      }\r\n    },\r\n    track: {\r\n      Formidable: {\r\n        id: '2AMysGXOe0zzZJMtH3Nizb'\r\n      }\r\n    }\r\n  };\r\n\r\n  it('Required environment variable', () => {\r\n    assert.isDefined(process.env.MBUSER, 'process.env.MBUSER');\r\n    assert.isDefined(process.env.MBPWD, 'process.env.MBPWD');\r\n  });\r\n\r\n  it('Extract CSRF', () => {\r\n    const html = fs.readFileSync(path.join(__dirname, 'csrf.html'), 'utf8');\r\n    const csrf = MusicBrainzApi.fetchCsrf(html);\r\n    assert.deepStrictEqual(csrf, {\r\n      sessionKey: 'csrf_token:x0VIlHob5nPcWKqJIwNPwE5Y3kE+nGQ9fccgTSYbuMU=',\r\n      token: '6G9f/xJ6Y4fLVvfYGHrzBUM34j6hy4CJrBi3VkVwO9I='\r\n    }, 'CSRF data');\r\n  });\r\n\r\n  describe('Read metadata', () => {\r\n\r\n    describe('Lookup', () => {\r\n\r\n      it('get area', async () => {\r\n        const area = await mbApi.getArea(mbid.area.Belgium);\r\n        assert.strictEqual(area.id, mbid.area.Belgium);\r\n        assert.strictEqual(area.name, 'Belgium');\r\n      });\r\n\r\n      it('get artist', async () => {\r\n        const artist = await mbApi.getArtist(mbid.artist.Stromae);\r\n        assert.strictEqual(artist.id, mbid.artist.Stromae);\r\n        assert.strictEqual(artist.name, 'Stromae');\r\n      });\r\n\r\n      describe('Release', () => {\r\n\r\n        it('get release Formidable', async () => {\r\n          const release = await mbApi.getRelease(mbid.release.Formidable);\r\n          assert.strictEqual(release.id, mbid.release.Formidable);\r\n          assert.strictEqual(release.title, 'Formidable');\r\n        });\r\n\r\n        it('check release Anomalie', async () => {\r\n          const release = await mbApi.getRelease(mbid.release.Anomalie);\r\n          assert.strictEqual(release.id, mbid.release.Anomalie);\r\n          assert.strictEqual(release.title, 'Anomalie');\r\n        });\r\n\r\n        [\r\n          {inc: 'artist-credits', key: 'artist-credit'},\r\n          {inc: 'artists', key: 'artist-credit'},\r\n          {inc: 'collections', key: 'collections'},\r\n          {inc: 'labels', key: 'release-events'},\r\n          {inc: 'media', key: 'media'},\r\n          // {inc: 'recordings', key: 'recordings'},\r\n          {inc: 'release-groups', key: 'release-group'}\r\n        ].forEach(inc => {\r\n\r\n          it(`get release, include: '${inc.inc}'`, async () => {\r\n            const release = await mbApi.getRelease(mbid.release.Formidable, [inc.inc as any]);\r\n            assert.strictEqual(release.id, mbid.release.Formidable);\r\n            assert.strictEqual(release.title, 'Formidable');\r\n            assert.isDefined(release[inc.key], `Should include '${inc.key}'`);\r\n          });\r\n        });\r\n\r\n      });\r\n\r\n      describe('Release-group', () => {\r\n\r\n        it('get release-group', async () => {\r\n          const releaseGroup = await mbApi.getReleaseGroup(mbid.releaseGroup.Formidable);\r\n          assert.strictEqual(releaseGroup.id, mbid.releaseGroup.Formidable);\r\n          assert.strictEqual(releaseGroup.title, 'Formidable');\r\n        });\r\n\r\n        [\r\n          {inc: 'artist-credits', key: 'artist-credit'}\r\n        ].forEach(inc => {\r\n\r\n          it(`get release-group, include: '${inc.inc}'`, async () => {\r\n            const group = await mbApi.getReleaseGroup(mbid.releaseGroup.Formidable, [inc.inc as any]);\r\n            assert.strictEqual(group.id, mbid.releaseGroup.Formidable);\r\n            assert.strictEqual(group.title, 'Formidable');\r\n            assert.isDefined(group[inc.key], `Should include '${inc.key}'`);\r\n          });\r\n        });\r\n\r\n      });\r\n\r\n      it('get work', async () => {\r\n        const work = await mbApi.getWork(mbid.work.Formidable);\r\n        assert.strictEqual(work.id, mbid.work.Formidable);\r\n        assert.strictEqual(work.title, 'Formidable');\r\n      });\r\n\r\n      it('get label', async () => {\r\n        const label = await mbApi.getLabel(mbid.label.Mosaert);\r\n        assert.strictEqual(label.id, mbid.label.Mosaert);\r\n        assert.strictEqual(label.name, 'Mosaert');\r\n      });\r\n\r\n      describe('Recording', () => {\r\n\r\n        it('get recording', async () => {\r\n          const recording = await mbApi.getRecording(mbid.recording.Formidable);\r\n          assert.strictEqual(recording.id, mbid.recording.Formidable);\r\n          assert.strictEqual(recording.title, 'Formidable');\r\n          assert.isUndefined(recording.isrcs);\r\n          assert.isUndefined(recording['artist-credit']);\r\n          assert.isUndefined(recording.releases);\r\n        });\r\n\r\n        [\r\n          {inc: 'isrcs', key: 'isrcs'},\r\n          {inc: 'artist-credits', key: 'artist-credit'},\r\n          {inc: 'artists', key: 'artist-credit'},\r\n          {inc: 'releases', key: 'releases'}\r\n        ].forEach(inc => {\r\n\r\n          it(`get recording, include: '${inc.inc}'`, async () => {\r\n            const recording = await mbApi.getRecording(mbid.recording.Formidable, [inc.inc as any]);\r\n            assert.strictEqual(recording.id, mbid.recording.Formidable);\r\n            assert.strictEqual(recording.title, 'Formidable');\r\n            assert.isDefined(recording[inc.key], `Should include '${inc.key}'`);\r\n          });\r\n        });\r\n\r\n        it('get extended recording', async () => {\r\n          const recording = await mbApi.getRecording(mbid.recording.Formidable, ['isrcs', 'artists', 'releases', 'url-rels']);\r\n          assert.strictEqual(recording.id, mbid.recording.Formidable);\r\n          assert.strictEqual(recording.title, 'Formidable');\r\n          assert.isDefined(recording.isrcs);\r\n          assert.isDefined(recording['artist-credit']);\r\n          // assert.isDefined(recording.releases);\r\n        });\r\n      });\r\n\r\n    });\r\n\r\n    describe('Query', () => {\r\n\r\n      it('query: Queen - We Will Rock You', async () => {\r\n        const query = 'query=\"We Will Rock You\" AND arid:0383dadf-2a4e-4d10-a46a-e9e041da8eb3';\r\n        const result = await mbApi.search<mb.IReleaseGroupList>('release-group', {query});\r\n        assert.isAtLeast(result.count, 1);\r\n      });\r\n\r\n    });\r\n\r\n    describe('Search', () => {\r\n\r\n      describe('generic search', () => {\r\n\r\n        it('find artist: Stromae', async () => {\r\n          const result = await mbApi.search('artist', 'Stromae');\r\n          assert.isAtLeast(result.count, 1);\r\n        });\r\n\r\n      });\r\n\r\n      describe('searchArtist', () => {\r\n\r\n        it('find artist: Stromae', async () => {\r\n          const result = await mbApi.searchArtist('Stromae');\r\n          assert.isAtLeast(result.count, 1);\r\n          assert.isAtLeast(result.artists.length, 1);\r\n          assert.strictEqual(result.artists[0].id, mbid.artist.Stromae);\r\n        });\r\n\r\n      });\r\n\r\n      describe('searchReleaseGroup', () => {\r\n\r\n        it('find release-group: Racine carrée', async () => {\r\n          const result = await mbApi.searchReleaseGroup('Racine carrée');\r\n          assert.isAtLeast(result.count, 1);\r\n          assert.isAtLeast(result['release-groups'].length, 1);\r\n          assert.strictEqual(result['release-groups'][0].id, mbid.releaseGroup.RacineCarree);\r\n        });\r\n\r\n        it('find release-group: Racine carrée, by artist and group name', async () => {\r\n          const result = await mbApi.searchReleaseGroup({release: 'Racine carrée', artist: 'Stromae'});\r\n          assert.isAtLeast(result.count, 1);\r\n          assert.isAtLeast(result['release-groups'].length, 1);\r\n          assert.strictEqual(result['release-groups'][0].id, mbid.releaseGroup.RacineCarree);\r\n        });\r\n      });\r\n\r\n      describe('searchRelease', () => {\r\n\r\n        it('find release-group: Racine carrée', async () => {\r\n          const result = await mbApi.searchRelease({release: 'Racine carrée'});\r\n          assert.isAtLeast(result.count, 2);\r\n          assert.isAtLeast(result.releases.length, 2);\r\n          assert.includeMembers(result.releases.map(release => release.id), mbid.release.RacineCarree);\r\n        });\r\n\r\n        it('find release by barcode', async () => {\r\n          const result = await mbApi.searchRelease({barcode: 602537479870});\r\n          assert.isAtLeast(result.count, 1);\r\n          assert.isAtLeast(result.releases.length, 1);\r\n          assert.equal(result.releases[0].id, mbid.release.RacineCarree[2]);\r\n        });\r\n\r\n      });\r\n\r\n      describe('searchArea', () => {\r\n\r\n        it('find area by name', async () => {\r\n          const result = await mbApi.searchArea('Île-de-France');\r\n          assert.isAtLeast(result.count, 1);\r\n          assert.isAtLeast(result.areas.length, 1);\r\n          assert.strictEqual(result.areas[0].id, mbid.area.IleDeFrance);\r\n        });\r\n      });\r\n\r\n      describe('searchUrl', () => {\r\n\r\n        const spotifyUrl = 'https://open.spotify.com/album/' + spotify.album.RacineCarree.id;\r\n\r\n        it('find url by url', async () => {\r\n          const result = await mbApi.searchUrl({url: spotifyUrl});\r\n          assert.isAtLeast(result.count, 1);\r\n          assert.isAtLeast(result.urls.length, 1);\r\n          assert.strictEqual(result.urls[0].resource, spotifyUrl);\r\n        });\r\n      });\r\n    });\r\n\r\n  });\r\n\r\n  describe('Submit API', () => {\r\n\r\n    it('Post ISRC Formidable', async () => {\r\n      const isrc_Formidable = 'BET671300161';\r\n      const xmlMetadata = new XmlMetadata();\r\n      const xmlRecording = xmlMetadata.pushRecording(mbid.recording.Formidable);\r\n      xmlRecording.isrcList.pushIsrc(isrc_Formidable);\r\n\r\n      await mbTestApi.post('recording', xmlMetadata);\r\n    });\r\n\r\n  });\r\n\r\n  /**\r\n   * https://wiki.musicbrainz.org/Development/Release_Editor_Seeding\r\n   */\r\n  describe.skip('User (bot) post form-data API', () => {\r\n\r\n    it('login & logout', async () => {\r\n      for (let n = 1; n <= 2; ++n) {\r\n        assert.isTrue(await mbTestApi.login(), `Login ${n}`);\r\n        assert.isTrue(await mbTestApi.logout(), `Logout ${n}`);\r\n      }\r\n    });\r\n\r\n    describe('Recording', () => {\r\n\r\n      it('add link', async () => {\r\n        const recording = await mbTestApi.getRecording(mbid.recording.Formidable);\r\n        assert.strictEqual(recording.id, mbid.recording.Formidable);\r\n        assert.strictEqual(recording.title, 'Formidable');\r\n\r\n        await mbTestApi.addUrlToRecording(recording, {\r\n          linkTypeId: LinkType.stream_for_free,\r\n          text: 'https://open.spotify.com/track/' + spotify.track.Formidable.id\r\n        });\r\n      });\r\n\r\n      it('add Spotify-ID', async () => {\r\n        const recording = await mbTestApi.getRecording(mbid.recording.Formidable);\r\n\r\n        const editNote = `Unit-test musicbrainz-api (${appUrl}), test augment recording with Spotify URL & ISRC`;\r\n        await mbTestApi.addSpotifyIdToRecording(recording, spotify.track.Formidable.id, editNote);\r\n      });\r\n\r\n      it('add Spotify-ID to recording with ISRC', async () => {\r\n        // https://test.musicbrainz.org/recording/a75b85bf-63dd-4fe1-8008-d15541b93bac\r\n        const recording_id = 'a75b85bf-63dd-4fe1-8008-d15541b93bac';\r\n\r\n        const recording = await mbTestApi.getRecording(recording_id);\r\n        const editNote = `Unit-test musicbrainz-api (${appUrl}), test augment recording with Spotify URL & ISRC`;\r\n        await mbTestApi.addSpotifyIdToRecording(recording, '3ZDO5YINwfoifRQ3ElshPM', editNote);\r\n      });\r\n\r\n    });\r\n\r\n    describe('ISRC', () => {\r\n\r\n      it('add ISRC', async () => {\r\n        const recording = await mbTestApi.getRecording(mbid.recording.Formidable, ['isrcs']);\r\n        assert.strictEqual(recording.id, mbid.recording.Formidable);\r\n        assert.strictEqual(recording.title, 'Formidable');\r\n\r\n        await mbTestApi.addIsrc(recording, 'BET671300161');\r\n      });\r\n\r\n    });\r\n\r\n    /**\r\n     * https://musicbrainz.org/doc/Development/XML_Web_Service/Version_2#ISRC_submission\r\n     */\r\n    describe('ISRC submission', () => {\r\n\r\n      it('add ISRC', async () => {\r\n        const xmlMedata = new XmlMetadata();\r\n        const xmlRec = xmlMedata.pushRecording('94fb868b-9233-4f9e-966b-e8036bf7461e');\r\n        xmlRec.isrcList.pushIsrc('GB5EM1801762');\r\n        await mbTestApi.post('recording', xmlMedata);\r\n      });\r\n\r\n    });\r\n\r\n  });\r\n\r\n});\r\n
-Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
-<+>UTF-8
-===================================================================
-diff --git a/test/test-musicbrainz-api.ts b/test/test-musicbrainz-api.ts
---- a/test/test-musicbrainz-api.ts	(revision 34904480bc8291aefe77a94593cf8a0ef1c85a91)
-+++ b/test/test-musicbrainz-api.ts	(date 1641463729365)
-@@ -4,6 +4,7 @@
- import * as mb from '../src/musicbrainz.types';
- import * as fs from 'fs';
- import * as path from 'path';
-+import { IArtist } from '../lib/musicbrainz.types';
- 
- const packageInfo = require('../package.json');
- 
-@@ -298,6 +299,20 @@
-           assert.isAtLeast(result.releases.length, 1);
-           assert.equal(result.releases[0].id, mbid.release.RacineCarree[2]);
-         });
-+
-+        it('find release by barcode', async () => {
-+          const result = await mbApi.searchRelease({barcode: 602537479870});
-+          assert.isAtLeast(result.count, 1);
-+          assert.isAtLeast(result.releases.length, 1);
-+          assert.equal(result.releases[0].id, mbid.release.RacineCarree[2]);
-+        });
-+
-+        it('find releases by artist', async () => {
-+          const result = await mbApi.searchRelease({artist: 'eeb41a1e-4326-4d04-8c47-0f564ceecd68'});
-+          assert.isAtLeast(result.count, 1);
-+          assert.isAtLeast(result.releases.length, 1);
-+          assert.equal(result.releases[0].id, mbid.release.RacineCarree[2]);
-+        });
- 
-       });
- 
-@@ -410,4 +425,18 @@
- 
-   });
- 
-+  it('try something', async () => {
-+    const artist_mbid = 'eeb41a1e-4326-4d04-8c47-0f564ceecd68';
-+    const searchResult: IArtist = await mbApi.getArtist(artist_mbid, [
-+      'artist-rels',
-+      'releases',
-+      'recordings',
-+      'url-rels'
-+    ]);
-+
-+    const result = await mbApi.searchRelease({artist: 'eeb41a1e-4326-4d04-8c47-0f564ceecd68'}, 25);
-+
-+    assert.isNotNull(result);
-+  });
-+
- });

package/.idea/shelf/Uncommitted_changes_before_Update_at_6-1-2022_11_38__Default_Changelist_.xml

@@ -1,4 +0,0 @@
-<changelist name="Uncommitted_changes_before_Update_at_6-1-2022_11_38_[Default_Changelist]" date="1641465535745" recycled="true" deleted="true">
-  <option name="PATH" value="$PROJECT_DIR$/.idea/shelf/Uncommitted_changes_before_Update_at_6-1-2022_11_38_[Default_Changelist]/shelved.patch" />
-  <option name="DESCRIPTION" value="Uncommitted changes before Update at 6-1-2022 11:38 [Default Changelist]" />
-</changelist>