@cyanheads/musicbrainz-mcp-server 0.2.0 → 0.2.1
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.
- package/AGENTS.md +24 -11
- package/CLAUDE.md +24 -11
- package/Dockerfile +3 -3
- package/README.md +39 -23
- package/changelog/0.2.x/0.2.1.md +32 -0
- package/dist/config/server-config.d.ts +1 -0
- package/dist/config/server-config.d.ts.map +1 -1
- package/dist/config/server-config.js +5 -0
- package/dist/config/server-config.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/entity.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/entity.resource.js +6 -2
- package/dist/mcp-server/resources/definitions/entity.resource.js.map +1 -1
- package/dist/mcp-server/tools/definitions/_pagination.d.ts +12 -0
- package/dist/mcp-server/tools/definitions/_pagination.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/_pagination.js +46 -0
- package/dist/mcp-server/tools/definitions/_pagination.js.map +1 -0
- package/dist/mcp-server/tools/definitions/_shared.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/_shared.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/_shared.js +22 -6
- package/dist/mcp-server/tools/definitions/_shared.js.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/browse-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js +40 -29
- package/dist/mcp-server/tools/definitions/browse-entities.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/get-artist.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts +7 -0
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js +45 -8
- package/dist/mcp-server/tools/definitions/get-cover-art.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts +13 -0
- package/dist/mcp-server/tools/definitions/get-recording.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recording.tool.js +23 -2
- package/dist/mcp-server/tools/definitions/get-recording.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts +13 -3
- package/dist/mcp-server/tools/definitions/get-release.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-release.tool.js +47 -5
- package/dist/mcp-server/tools/definitions/get-release.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts +3 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-work.tool.js +4 -4
- package/dist/mcp-server/tools/definitions/get-work.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +41 -6
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js +26 -7
- package/dist/mcp-server/tools/definitions/lookup-identifier.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts +2 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-entities.tool.js +13 -14
- package/dist/mcp-server/tools/definitions/search-entities.tool.js.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.d.ts +8 -3
- package/dist/services/musicbrainz/musicbrainz-service.d.ts.map +1 -1
- package/dist/services/musicbrainz/musicbrainz-service.js +18 -4
- package/dist/services/musicbrainz/musicbrainz-service.js.map +1 -1
- package/dist/services/musicbrainz/release-appearances.d.ts +16 -0
- package/dist/services/musicbrainz/release-appearances.d.ts.map +1 -0
- package/dist/services/musicbrainz/release-appearances.js +15 -0
- package/dist/services/musicbrainz/release-appearances.js.map +1 -0
- package/dist/services/musicbrainz/types.d.ts +6 -3
- package/dist/services/musicbrainz/types.d.ts.map +1 -1
- package/package.json +6 -6
- package/server.json +17 -3
|
@@ -9,9 +9,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
9
9
|
release: "release";
|
|
10
10
|
"release-group": "release-group";
|
|
11
11
|
}>>;
|
|
12
|
+
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
13
|
+
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
12
14
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
13
15
|
mbid: import("zod").ZodString;
|
|
14
16
|
entityType: import("zod").ZodString;
|
|
17
|
+
offset: import("zod").ZodNumber;
|
|
15
18
|
representativeRelease: import("zod").ZodOptional<import("zod").ZodString>;
|
|
16
19
|
images: import("zod").ZodArray<import("zod").ZodObject<{
|
|
17
20
|
id: import("zod").ZodString;
|
|
@@ -37,6 +40,10 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
37
40
|
readonly recovery: "No release or release-group exists with that MBID. Check that entity_type matches the MBID (a release-group MBID needs entity_type=release-group), or find the MBID with musicbrainz_search_entities.";
|
|
38
41
|
}], {
|
|
39
42
|
readonly hasArt: import("zod").ZodBoolean;
|
|
43
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
44
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
45
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
46
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
40
47
|
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
41
48
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
42
49
|
mbid: import("zod").ZodString;
|
|
@@ -97,10 +104,11 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
97
104
|
work: "work";
|
|
98
105
|
}>;
|
|
99
106
|
query: import("zod").ZodString;
|
|
100
|
-
limit: import("zod").ZodDefault<import("zod").ZodNumber
|
|
107
|
+
limit: import("zod").ZodDefault<import("zod").ZodLazy<import("zod").ZodNumber>>;
|
|
101
108
|
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
102
109
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
103
110
|
entityType: import("zod").ZodString;
|
|
111
|
+
offset: import("zod").ZodNumber;
|
|
104
112
|
results: import("zod").ZodArray<import("zod").ZodObject<{
|
|
105
113
|
mbid: import("zod").ZodString;
|
|
106
114
|
name: import("zod").ZodString;
|
|
@@ -168,6 +176,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
168
176
|
targetType: import("zod").ZodString;
|
|
169
177
|
targetId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
170
178
|
targetName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
179
|
+
targetDisambiguation: import("zod").ZodOptional<import("zod").ZodString>;
|
|
180
|
+
orderingKey: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
171
181
|
begin: import("zod").ZodOptional<import("zod").ZodString>;
|
|
172
182
|
end: import("zod").ZodOptional<import("zod").ZodString>;
|
|
173
183
|
}, import("zod/v4/core").$strip>>;
|
|
@@ -192,6 +202,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
192
202
|
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
193
203
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
194
204
|
mbid: import("zod").ZodString;
|
|
205
|
+
media_offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
206
|
+
media_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
195
207
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
196
208
|
mbid: import("zod").ZodString;
|
|
197
209
|
title: import("zod").ZodString;
|
|
@@ -216,6 +228,9 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
216
228
|
labelName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
217
229
|
catalogNumber: import("zod").ZodOptional<import("zod").ZodString>;
|
|
218
230
|
}, import("zod/v4/core").$strip>>;
|
|
231
|
+
mediaOffset: import("zod").ZodNumber;
|
|
232
|
+
mediaTotal: import("zod").ZodNumber;
|
|
233
|
+
trackTotal: import("zod").ZodNumber;
|
|
219
234
|
media: import("zod").ZodArray<import("zod").ZodObject<{
|
|
220
235
|
position: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
221
236
|
format: import("zod").ZodOptional<import("zod").ZodString>;
|
|
@@ -245,7 +260,12 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
245
260
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
246
261
|
readonly when: "The MBID is well-formed but no release exists with it (MusicBrainz returns HTTP 404).";
|
|
247
262
|
readonly recovery: "No release exists with that MBID. Verify the ID, or search by title with musicbrainz_search_entities.";
|
|
248
|
-
}],
|
|
263
|
+
}], {
|
|
264
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
265
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
266
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
267
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
268
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
249
269
|
mbid: import("zod").ZodString;
|
|
250
270
|
inc_relationships: import("zod").ZodDefault<import("zod").ZodBoolean>;
|
|
251
271
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
@@ -268,6 +288,17 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
268
288
|
date: import("zod").ZodOptional<import("zod").ZodString>;
|
|
269
289
|
country: import("zod").ZodOptional<import("zod").ZodString>;
|
|
270
290
|
}, import("zod/v4/core").$strip>>;
|
|
291
|
+
releaseAppearanceSummary: import("zod").ZodObject<{
|
|
292
|
+
shown: import("zod").ZodNumber;
|
|
293
|
+
cap: import("zod").ZodNumber;
|
|
294
|
+
completeness: import("zod").ZodEnum<{
|
|
295
|
+
complete: "complete";
|
|
296
|
+
truncated: "truncated";
|
|
297
|
+
unknown: "unknown";
|
|
298
|
+
}>;
|
|
299
|
+
totalCount: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
300
|
+
notice: import("zod").ZodString;
|
|
301
|
+
}, import("zod/v4/core").$strip>;
|
|
271
302
|
relationships: import("zod").ZodArray<import("zod").ZodObject<{
|
|
272
303
|
type: import("zod").ZodString;
|
|
273
304
|
direction: import("zod").ZodOptional<import("zod").ZodString>;
|
|
@@ -275,6 +306,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
275
306
|
targetType: import("zod").ZodString;
|
|
276
307
|
targetId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
277
308
|
targetName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
309
|
+
targetDisambiguation: import("zod").ZodOptional<import("zod").ZodString>;
|
|
310
|
+
orderingKey: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
278
311
|
begin: import("zod").ZodOptional<import("zod").ZodString>;
|
|
279
312
|
end: import("zod").ZodOptional<import("zod").ZodString>;
|
|
280
313
|
}, import("zod/v4/core").$strip>>;
|
|
@@ -320,6 +353,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
320
353
|
targetType: import("zod").ZodString;
|
|
321
354
|
targetId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
322
355
|
targetName: import("zod").ZodOptional<import("zod").ZodString>;
|
|
356
|
+
targetDisambiguation: import("zod").ZodOptional<import("zod").ZodString>;
|
|
357
|
+
orderingKey: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
323
358
|
begin: import("zod").ZodOptional<import("zod").ZodString>;
|
|
324
359
|
end: import("zod").ZodOptional<import("zod").ZodString>;
|
|
325
360
|
}, import("zod/v4/core").$strip>>;
|
|
@@ -429,8 +464,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
429
464
|
}, {
|
|
430
465
|
readonly reason: "invalid_identifier";
|
|
431
466
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
432
|
-
readonly when: "The ISRC/ISWC
|
|
433
|
-
readonly recovery: "ISRC
|
|
467
|
+
readonly when: "The ISRC/ISWC fails its accepted grammar locally or the dedicated endpoint rejects it with HTTP 400, or the barcode contains anything other than digits once spaces and hyphens are removed.";
|
|
468
|
+
readonly recovery: "ISRC accepts CCXXXYYNNNNN or CC-XXX-YY-NNNNN (e.g. USRC17607839), ignoring case and surrounding whitespace. ISWC accepts T plus ten digits, with optional hyphen after T, optional dots between three-digit groups, and optional hyphen/dot before the check digit; whitespace and case are ignored (e.g. T-010.140.236-1 or T0101402361). A barcode is UPC/EAN digits (e.g. 075678164125 — spaces and hyphens ignored, wildcards rejected). Verify the format; check digits are not repaired.";
|
|
434
469
|
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
435
470
|
target_type: import("zod").ZodEnum<{
|
|
436
471
|
artist: "artist";
|
|
@@ -451,7 +486,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
451
486
|
work: import("zod").ZodOptional<import("zod").ZodString>;
|
|
452
487
|
area: import("zod").ZodOptional<import("zod").ZodString>;
|
|
453
488
|
}, import("zod/v4/core").$catchall<import("zod").ZodUnknown>>;
|
|
454
|
-
limit: import("zod").ZodDefault<import("zod").ZodNumber
|
|
489
|
+
limit: import("zod").ZodDefault<import("zod").ZodLazy<import("zod").ZodNumber>>;
|
|
455
490
|
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
456
491
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
457
492
|
targetType: import("zod").ZodString;
|
|
@@ -473,7 +508,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
473
508
|
readonly reason: "invalid_link";
|
|
474
509
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
475
510
|
readonly when: "A parent key is unknown, aliases collide, not exactly one nonempty parent is supplied, or the MBID/parent combination is invalid.";
|
|
476
|
-
readonly recovery: "Provide exactly one parent key: artist, label, release-group, release, recording,
|
|
511
|
+
readonly recovery: "Provide exactly one parent key with a nonzero hexadecimal UUID MBID. Accepted parents by target: artist → area, recording, release, release-group, work; label → area, release; release-group → artist, release; release → area, artist, label, recording, release-group; recording → artist, release, work; work → artist. releaseGroup and release_group alias release-group; never combine aliases.";
|
|
477
512
|
}, {
|
|
478
513
|
readonly reason: "entity_not_found";
|
|
479
514
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,eAAO,MAAM,kBAAkB
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAW9B,CAAC"}
|
|
@@ -53,7 +53,7 @@ export declare const lookupIdentifierTool: import("@cyanheads/mcp-ts-core").Tool
|
|
|
53
53
|
}, {
|
|
54
54
|
readonly reason: "invalid_identifier";
|
|
55
55
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
56
|
-
readonly when: "The ISRC/ISWC
|
|
57
|
-
readonly recovery: "ISRC
|
|
56
|
+
readonly when: "The ISRC/ISWC fails its accepted grammar locally or the dedicated endpoint rejects it with HTTP 400, or the barcode contains anything other than digits once spaces and hyphens are removed.";
|
|
57
|
+
readonly recovery: "ISRC accepts CCXXXYYNNNNN or CC-XXX-YY-NNNNN (e.g. USRC17607839), ignoring case and surrounding whitespace. ISWC accepts T plus ten digits, with optional hyphen after T, optional dots between three-digit groups, and optional hyphen/dot before the check digit; whitespace and case are ignored (e.g. T-010.140.236-1 or T0101402361). A barcode is UPC/EAN digits (e.g. 075678164125 — spaces and hyphens ignored, wildcards rejected). Verify the format; check digits are not repaired.";
|
|
58
58
|
}], undefined>;
|
|
59
59
|
//# sourceMappingURL=lookup-identifier.tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lookup-identifier.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAsD3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"lookup-identifier.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAsD3E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyN/B,CAAC"}
|
|
@@ -70,8 +70,8 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
|
|
|
70
70
|
{
|
|
71
71
|
reason: 'invalid_identifier',
|
|
72
72
|
code: JsonRpcErrorCode.ValidationError,
|
|
73
|
-
when: 'The ISRC/ISWC
|
|
74
|
-
recovery: 'ISRC
|
|
73
|
+
when: 'The ISRC/ISWC fails its accepted grammar locally or the dedicated endpoint rejects it with HTTP 400, or the barcode contains anything other than digits once spaces and hyphens are removed.',
|
|
74
|
+
recovery: 'ISRC accepts CCXXXYYNNNNN or CC-XXX-YY-NNNNN (e.g. USRC17607839), ignoring case and surrounding whitespace. ISWC accepts T plus ten digits, with optional hyphen after T, optional dots between three-digit groups, and optional hyphen/dot before the check digit; whitespace and case are ignored (e.g. T-010.140.236-1 or T0101402361). A barcode is UPC/EAN digits (e.g. 075678164125 — spaces and hyphens ignored, wildcards rejected). Verify the format; check digits are not repaired.',
|
|
75
75
|
},
|
|
76
76
|
],
|
|
77
77
|
input: z.object({
|
|
@@ -81,7 +81,16 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
|
|
|
81
81
|
value: z
|
|
82
82
|
.string()
|
|
83
83
|
.min(1)
|
|
84
|
-
.describe('
|
|
84
|
+
.describe('ISRC: compact CCXXXYYNNNNN or grouped CC-XXX-YY-NNNNN (e.g. GBAYE9701274 or GB-AYE-97-01274), case-insensitive with surrounding whitespace. ISWC: T plus ten digits, optional hyphen after T, optional dots between three-digit groups, optional hyphen/dot before the check digit (e.g. T-010.140.236-1 or T0101402361); whitespace and case are ignored. Echoes canonical uppercase ISRC or T-DDD.DDD.DDD-C ISWC. Barcode: UPC/EAN digits, e.g. 075678164125; spaces and hyphens are ignored, other characters rejected.')
|
|
85
|
+
.meta({
|
|
86
|
+
examples: [
|
|
87
|
+
'GBAYE9701274',
|
|
88
|
+
'GB-AYE-97-01274',
|
|
89
|
+
'T-010.140.236-1',
|
|
90
|
+
'T0101402361',
|
|
91
|
+
'075678164125',
|
|
92
|
+
],
|
|
93
|
+
}),
|
|
85
94
|
}),
|
|
86
95
|
// The resolved entity type varies by id_type, so `result` is a discriminated
|
|
87
96
|
// union on `kind`. Wrapped in an object because the tool() output slot is a
|
|
@@ -121,9 +130,14 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
|
|
|
121
130
|
ctx.log.info('musicbrainz_lookup_identifier', { id_type: input.id_type, value: input.value });
|
|
122
131
|
const service = getMusicBrainzService();
|
|
123
132
|
if (input.id_type === 'isrc') {
|
|
133
|
+
const supplied = input.value.trim().toUpperCase();
|
|
134
|
+
if (!/^(?:[A-Z]{2}[A-Z0-9]{3}\d{7}|[A-Z]{2}-[A-Z0-9]{3}-\d{2}-\d{5})$/.test(supplied)) {
|
|
135
|
+
throw ctx.fail('invalid_identifier', 'ISRC must be CCXXXYYNNNNN or CC-XXX-YY-NNNNN.');
|
|
136
|
+
}
|
|
137
|
+
const identifier = supplied.replaceAll('-', '');
|
|
124
138
|
let envelope;
|
|
125
139
|
try {
|
|
126
|
-
envelope = await service.resolveIsrc(
|
|
140
|
+
envelope = await service.resolveIsrc(identifier, ctx, { signal: ctx.signal });
|
|
127
141
|
}
|
|
128
142
|
catch (error) {
|
|
129
143
|
const reason = classifyIdentifierError(error);
|
|
@@ -145,12 +159,17 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
|
|
|
145
159
|
if (recordings.length === 0) {
|
|
146
160
|
throw ctx.fail('identifier_not_found', `No recording carries ISRC ${input.value}.`);
|
|
147
161
|
}
|
|
148
|
-
return { result: { kind: 'recordings', identifier
|
|
162
|
+
return { result: { kind: 'recordings', identifier, recordings } };
|
|
149
163
|
}
|
|
150
164
|
if (input.id_type === 'iswc') {
|
|
165
|
+
const groups = /^T-?(\d{3})\.?(\d{3})\.?(\d{3})[-.]?(\d)$/.exec(input.value.replace(/\s/g, '').toUpperCase());
|
|
166
|
+
if (!groups) {
|
|
167
|
+
throw ctx.fail('invalid_identifier', 'ISWC must be T plus ten digits with optional group punctuation, e.g. T-010.140.236-1.');
|
|
168
|
+
}
|
|
169
|
+
const identifier = `T-${groups[1]}.${groups[2]}.${groups[3]}-${groups[4]}`;
|
|
151
170
|
let envelope;
|
|
152
171
|
try {
|
|
153
|
-
envelope = await service.resolveIswc(
|
|
172
|
+
envelope = await service.resolveIswc(identifier, ctx, { signal: ctx.signal });
|
|
154
173
|
}
|
|
155
174
|
catch (error) {
|
|
156
175
|
const reason = classifyIdentifierError(error);
|
|
@@ -168,7 +187,7 @@ export const lookupIdentifierTool = tool('musicbrainz_lookup_identifier', {
|
|
|
168
187
|
if (works.length === 0) {
|
|
169
188
|
throw ctx.fail('identifier_not_found', `No work carries ISWC ${input.value}.`);
|
|
170
189
|
}
|
|
171
|
-
return { result: { kind: 'works', identifier
|
|
190
|
+
return { result: { kind: 'works', identifier, works } };
|
|
172
191
|
}
|
|
173
192
|
// barcode — Lucene search filter on releases (ranked, not a dedicated endpoint).
|
|
174
193
|
// The value is interpolated into a Lucene query, so it must be pure digits:
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lookup-identifier.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpG;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAC9B,KAAc;IAEd,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,eAAe;QAAE,OAAO,oBAAoB,CAAC;IACjF,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ;QAAE,OAAO,sBAAsB,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC9C,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CAC1F,CAAC;KACD,QAAQ,CAAC,0CAA0C,CAAC,CAAC;AAExD,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CACxE,CAAC;KACD,QAAQ,CAAC,qCAAqC,CAAC,CAAC;AAEnD,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC5C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACrF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC;KACD,QAAQ,CAAC,2CAA2C,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,+BAA+B,EAAE;IACxE,KAAK,EAAE,2CAA2C;IAClD,WAAW,EACT,qhBAAqhB;IACvhB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,MAAM,EAAE;QACN;YACE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,8DAA8D;YACpE,QAAQ,EACN,yGAAyG;SAC5G;QACD;YACE,MAAM,EAAE,oBAAoB;YAC5B,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE
|
|
1
|
+
{"version":3,"file":"lookup-identifier.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/lookup-identifier.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -18,10 +18,11 @@ export declare const searchEntitiesTool: import("@cyanheads/mcp-ts-core").ToolDe
|
|
|
18
18
|
work: "work";
|
|
19
19
|
}>;
|
|
20
20
|
query: z.ZodString;
|
|
21
|
-
limit: z.ZodDefault<z.ZodNumber
|
|
21
|
+
limit: z.ZodDefault<z.ZodLazy<z.ZodNumber>>;
|
|
22
22
|
offset: z.ZodDefault<z.ZodNumber>;
|
|
23
23
|
}, z.core.$strip>, z.ZodObject<{
|
|
24
24
|
entityType: z.ZodString;
|
|
25
|
+
offset: z.ZodNumber;
|
|
25
26
|
results: z.ZodArray<z.ZodObject<{
|
|
26
27
|
mbid: z.ZodString;
|
|
27
28
|
name: z.ZodString;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"search-entities.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsIjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6G7B,CAAC"}
|
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
10
10
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
11
11
|
import { getMusicBrainzService, MusicBrainzService, } from '../../../services/musicbrainz/musicbrainz-service.js';
|
|
12
|
+
import { applyPageLimit, PageLimit, pageNotice } from './_pagination.js';
|
|
12
13
|
import { artistCreditString, formatDuration, normalizeArtistCredits, safeText } from './_shared.js';
|
|
13
14
|
const ENTITY_TYPES = ['artist', 'release-group', 'release', 'recording', 'work', 'label'];
|
|
14
15
|
const ResultSchema = z
|
|
@@ -131,17 +132,12 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
|
|
|
131
132
|
.string()
|
|
132
133
|
.min(1)
|
|
133
134
|
.describe('Lucene query string; must contain non-whitespace text. Plain text matches names/titles; field scoping (e.g. `artist:`, `country:`, `tag:`) is supported. Sent to MusicBrainz exactly as given.'),
|
|
134
|
-
limit:
|
|
135
|
-
.number()
|
|
136
|
-
.int()
|
|
137
|
-
.min(1)
|
|
138
|
-
.max(100)
|
|
139
|
-
.default(25)
|
|
140
|
-
.describe('Maximum results to return (1–100).'),
|
|
135
|
+
limit: PageLimit,
|
|
141
136
|
offset: z.number().int().min(0).default(0).describe('Result offset for pagination (0-based).'),
|
|
142
137
|
}),
|
|
143
138
|
output: z.object({
|
|
144
139
|
entityType: z.string().describe('The entity type that was searched.'),
|
|
140
|
+
offset: z.number().describe('The effective zero-based result offset used for this page.'),
|
|
145
141
|
results: z
|
|
146
142
|
.array(ResultSchema)
|
|
147
143
|
.describe('Ranked matches, in MusicBrainz score-descending order.'),
|
|
@@ -152,7 +148,7 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
|
|
|
152
148
|
notice: z
|
|
153
149
|
.string()
|
|
154
150
|
.optional()
|
|
155
|
-
.describe('
|
|
151
|
+
.describe('Limit clamp and pagination guidance, including zero matches, exhausted pages, and empty-page discrepancies.'),
|
|
156
152
|
},
|
|
157
153
|
async handler(input, ctx) {
|
|
158
154
|
ctx.log.info('musicbrainz_search_entities', {
|
|
@@ -165,21 +161,24 @@ export const searchEntitiesTool = tool('musicbrainz_search_entities', {
|
|
|
165
161
|
throw ctx.fail('blank_query', 'The search query is blank — it contains only whitespace.');
|
|
166
162
|
}
|
|
167
163
|
const service = getMusicBrainzService();
|
|
168
|
-
const
|
|
164
|
+
const limit = applyPageLimit(input.limit, 'musicbrainz_search_entities', ctx);
|
|
165
|
+
const envelope = await service.search(input.entityType, input.query, { limit, offset: input.offset }, ctx, { signal: ctx.signal });
|
|
169
166
|
const key = MusicBrainzService.pluralKey(input.entityType);
|
|
170
167
|
const rawHits = (envelope[key] ?? []);
|
|
171
168
|
const results = rawHits.map((h) => mapHit(input.entityType, h));
|
|
172
169
|
ctx.enrich.echo(input.query);
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
170
|
+
const total = envelope.count;
|
|
171
|
+
ctx.enrich.total(total);
|
|
172
|
+
const notice = pageNotice(total, input.offset, results.length, input.limit, limit, `No ${input.entityType} matched "${input.query}". Broaden the query, check spelling, or try a different entityType.`);
|
|
173
|
+
if (notice)
|
|
174
|
+
ctx.enrich.notice(notice);
|
|
175
|
+
return { entityType: input.entityType, offset: input.offset, results };
|
|
178
176
|
},
|
|
179
177
|
format: (result) => {
|
|
180
178
|
const lines = [
|
|
181
179
|
`## MusicBrainz ${result.entityType} search`,
|
|
182
180
|
`**Matches:** ${result.results.length}`,
|
|
181
|
+
`**Offset:** ${result.offset}`,
|
|
183
182
|
];
|
|
184
183
|
for (const r of result.results) {
|
|
185
184
|
lines.push(`\n### ${safeText(r.name)}${r.disambiguation ? ` (${safeText(r.disambiguation)})` : ''}`);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"search-entities.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-entities.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,+CAA+C,CAAC;AAUvD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpG,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAEnG,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,wFAAwF,CACzF;IACH,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;IACvF,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uGAAuG,CACxG;IACH,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qGAAqG,CACtG;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2FAA2F,CAC5F;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,oFAAoF,CACrF;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACzF,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC7F,CAAC;KACD,QAAQ,CAAC,qFAAqF,CAAC,CAAC;AAEnG,SAAS,MAAM,CAAC,IAAgB,EAAE,GAAY;IAC5C,MAAM,IAAI,GAAG,GAAmF,CAAC;IACjG,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAEnD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;YAClB,KAAK;YACL,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,GAAc,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACnB,KAAK;YACL,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,GAAmB,CAAC;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,EAAE;YACV,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACnB,KAAK;YACL,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,YAAY,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;YAC5E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;IACJ,CAAC;IACD,0BAA0B;IAC1B,MAAM,CAAC,GAAG,GAAmC,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,KAAK,eAAe,CAAC;IAChD,MAAM,IAAI,GAAG,cAAc;QACzB,CAAC,CAAE,CAAqB,CAAC,oBAAoB,CAAC;QAC9C,CAAC,CAAE,CAAgB,CAAC,IAAI,CAAC;IAC3B,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAE,CAAqB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,MAAM,MAAM,GAAG,CAAC,cAAc,CAAC,CAAC,CAAE,CAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,EAAE;QACV,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;QACnB,KAAK;QACL,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,YAAY,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzB,GAAG,CAAE,CAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAG,CAAgB,CAAC,OAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,6BAA6B,EAAE;IACpE,KAAK,EAAE,yCAAyC;IAChD,WAAW,EACT,0kBAA0kB;IAC5kB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAE9E,MAAM,EAAE;QACN;YACE,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,gBAAgB,CAAC,eAAe;YACtC,IAAI,EAAE,kEAAkE;YACxE,QAAQ,EACN,qHAAqH;SACxH;KACF;IAED,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACzE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,gMAAgM,CACjM;QACH,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC/F,CAAC;IAEF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;QACzF,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,YAAY,CAAC;aACnB,QAAQ,CAAC,wDAAwD,CAAC;KACtE,CAAC;IAEF,UAAU,EAAE;QACV,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QACzF,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6GAA6G,CAC9G;KACJ;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;YAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,8EAA8E;QAC9E,0EAA0E;QAC1E,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,0DAA0D,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,6BAA6B,EAAE,GAAG,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CACnC,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,KAAK,EACX,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAC/B,GAAG,EACH,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACvB,CAAC;QAEF,MAAM,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAc,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QAEhE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,MAAM,MAAM,GAAG,UAAU,CACvB,KAAK,EACL,KAAK,CAAC,MAAM,EACZ,OAAO,CAAC,MAAM,EACd,KAAK,CAAC,KAAK,EACX,KAAK,EACL,MAAM,KAAK,CAAC,UAAU,aAAa,KAAK,CAAC,KAAK,sEAAsE,CACrH,CAAC;QACF,IAAI,MAAM;YAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEtC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG;YACZ,kBAAkB,MAAM,CAAC,UAAU,SAAS;YAC5C,gBAAgB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE;YACvC,eAAe,MAAM,CAAC,MAAM,EAAE;SAC/B,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CACR,SAAS,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzF,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,CAAC,YAAY;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC1E,IAAI,CAAC,CAAC,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -41,11 +41,15 @@ export declare class MusicBrainzService {
|
|
|
41
41
|
private readonly userAgent;
|
|
42
42
|
constructor(baseUrl: string, contact: string, version: string, limiter: RateLimiter, cacheTtlSeconds: number, timeoutMs: number, maxRetries: number);
|
|
43
43
|
/** Full-text Lucene search over an entity type. Returns the raw search envelope. */
|
|
44
|
-
search(type: EntityType, query: string, params: SearchParams, ctx: Context, options?: CallOptions): Promise<SearchEnvelope
|
|
44
|
+
search(type: EntityType, query: string, params: SearchParams, ctx: Context, options?: CallOptions): Promise<SearchEnvelope & {
|
|
45
|
+
count: number;
|
|
46
|
+
}>;
|
|
45
47
|
/** Look up one entity by MBID with the requested `inc` sub-resources folded in. */
|
|
46
48
|
lookup<T>(type: EntityType, mbid: string, params: LookupParams, ctx: Context, options?: CallOptions): Promise<T>;
|
|
47
49
|
/** Paginate the complete set of `target` entities linked to one parent MBID. */
|
|
48
|
-
browse(target:
|
|
50
|
+
browse<T extends EntityType>(target: T, params: BrowseParams, ctx: Context, options?: CallOptions): Promise<BrowseEnvelope & Record<`${T}-count`, number>>;
|
|
51
|
+
/** Require an exact upstream total only on search and browse responses. */
|
|
52
|
+
private validateCount;
|
|
49
53
|
/**
|
|
50
54
|
* Resolve a standard identifier to entities. ISRC and ISWC are dedicated
|
|
51
55
|
* deterministic endpoints; barcode is a release search filter
|
|
@@ -60,7 +64,8 @@ export declare class MusicBrainzService {
|
|
|
60
64
|
static pluralKey(type: EntityType): keyof SearchEnvelope & keyof BrowseEnvelope;
|
|
61
65
|
/**
|
|
62
66
|
* Core request pipeline: cache check → rate-limited, retried fetch + parse →
|
|
63
|
-
* cache store.
|
|
67
|
+
* endpoint validation → cache store. Malformed totals neither retry nor cache.
|
|
68
|
+
* `path` is the full WS/2 path with query string (already
|
|
64
69
|
* `fmt=json`). `fetchWithTimeout` maps upstream HTTP 400 to `InvalidParams`,
|
|
65
70
|
* but that code is reserved for malformed JSON-RPC parameter shape; this
|
|
66
71
|
* service reclassifies the upstream domain rejection to `ValidationError`.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"musicbrainz-service.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgBtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAwBpB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAGxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YACmB,OAAO,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACE,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAGpC;IAED,oFAAoF;IACpF,MAAM,CACJ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,cAAc,CAAC,
|
|
1
|
+
{"version":3,"file":"musicbrainz-service.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -64,7 +64,7 @@ export class MusicBrainzService {
|
|
|
64
64
|
offset: String(params.offset),
|
|
65
65
|
fmt: 'json',
|
|
66
66
|
});
|
|
67
|
-
return this.request(`/${type}?${search.toString()}`, ctx, options);
|
|
67
|
+
return this.request(`/${type}?${search.toString()}`, ctx, options, (envelope) => this.validateCount(envelope.count));
|
|
68
68
|
}
|
|
69
69
|
/** Look up one entity by MBID with the requested `inc` sub-resources folded in. */
|
|
70
70
|
async lookup(type, mbid, params, ctx, options) {
|
|
@@ -85,7 +85,19 @@ export class MusicBrainzService {
|
|
|
85
85
|
if (target === 'release-group' || target === 'release' || target === 'recording') {
|
|
86
86
|
search.set('inc', 'artist-credits');
|
|
87
87
|
}
|
|
88
|
-
return await this.request(`/${target}?${search.toString()}`, ctx, options);
|
|
88
|
+
return await this.request(`/${target}?${search.toString()}`, ctx, options, (envelope) => this.validateCount(envelope[`${target}-count`]));
|
|
89
|
+
}
|
|
90
|
+
/** Require an exact upstream total only on search and browse responses. */
|
|
91
|
+
validateCount(count) {
|
|
92
|
+
if (typeof count !== 'number' ||
|
|
93
|
+
!Number.isFinite(count) ||
|
|
94
|
+
!Number.isInteger(count) ||
|
|
95
|
+
count < 0) {
|
|
96
|
+
throw serviceUnavailable('MusicBrainz returned a malformed response: the total count must be a finite nonnegative integer.', {
|
|
97
|
+
reason: 'musicbrainz_malformed_response',
|
|
98
|
+
recovery: { hint: 'Retry this query later; MusicBrainz returned an invalid total.' },
|
|
99
|
+
});
|
|
100
|
+
}
|
|
89
101
|
}
|
|
90
102
|
/**
|
|
91
103
|
* Resolve a standard identifier to entities. ISRC and ISWC are dedicated
|
|
@@ -108,7 +120,8 @@ export class MusicBrainzService {
|
|
|
108
120
|
}
|
|
109
121
|
/**
|
|
110
122
|
* Core request pipeline: cache check → rate-limited, retried fetch + parse →
|
|
111
|
-
* cache store.
|
|
123
|
+
* endpoint validation → cache store. Malformed totals neither retry nor cache.
|
|
124
|
+
* `path` is the full WS/2 path with query string (already
|
|
112
125
|
* `fmt=json`). `fetchWithTimeout` maps upstream HTTP 400 to `InvalidParams`,
|
|
113
126
|
* but that code is reserved for malformed JSON-RPC parameter shape; this
|
|
114
127
|
* service reclassifies the upstream domain rejection to `ValidationError`.
|
|
@@ -117,7 +130,7 @@ export class MusicBrainzService {
|
|
|
117
130
|
* `options.maxRetries` tighten the configured per-attempt timeout and retry
|
|
118
131
|
* count for this call only.
|
|
119
132
|
*/
|
|
120
|
-
async request(path, ctx, options) {
|
|
133
|
+
async request(path, ctx, options, validate) {
|
|
121
134
|
const key = cacheKey('mb', path);
|
|
122
135
|
if (this.cacheTtlSeconds > 0) {
|
|
123
136
|
const cached = await ctx.state.get(key);
|
|
@@ -156,6 +169,7 @@ export class MusicBrainzService {
|
|
|
156
169
|
}
|
|
157
170
|
throw error;
|
|
158
171
|
}
|
|
172
|
+
validate?.(result);
|
|
159
173
|
if (this.cacheTtlSeconds > 0) {
|
|
160
174
|
await ctx.state.set(key, result, { ttl: this.cacheTtlSeconds });
|
|
161
175
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"musicbrainz-service.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,qBAAqB,EACrB,SAAS,GACV,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD;;;;;;;GAOG;AACH,SAAS,QAAQ,CAAC,MAAc,EAAE,IAAY;IAC5C,OAAO,GAAG,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,2DAA2D;AAC3D,MAAM,aAAa,GAAoE;IACrF,MAAM,EAAE,SAAS;IACjB,eAAe,EAAE,gBAAgB;IACjC,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,YAAY;IACvB,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,QAAQ;CAChB,CAAC;AAmBF;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAIV,OAAO;IAGP,OAAO;IACP,eAAe;IACf,SAAS;IACT,UAAU;IATZ,SAAS,CAAS;IAEnC,YACmB,OAAe,EAChC,OAAe,EACf,OAAe,EACE,OAAoB,EACpB,eAAuB,EACvB,SAAiB,EACjB,UAAkB;uBANlB,OAAO;uBAGP,OAAO;+BACP,eAAe;yBACf,SAAS;0BACT,UAAU;QAE3B,IAAI,CAAC,SAAS,GAAG,0BAA0B,OAAO,MAAM,OAAO,IAAI,CAAC;IACtE,CAAC;IAED,oFAAoF;IACpF,MAAM,CACJ,IAAgB,EAChB,KAAa,EACb,MAAoB,EACpB,GAAY,EACZ,OAAqB;QAErB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,GAAG,EAAE,MAAM;SACZ,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,
|
|
1
|
+
{"version":3,"file":"musicbrainz-service.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/musicbrainz-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Lookup-only release appearance completeness for recording tool and resource views.
|
|
3
|
+
* @module services/musicbrainz/release-appearances
|
|
4
|
+
*/
|
|
5
|
+
import type { RawRecording } from './types.js';
|
|
6
|
+
/** Completeness evidence for the embedded upstream release page, without a count request. */
|
|
7
|
+
export interface ReleaseAppearanceSummary {
|
|
8
|
+
cap: number;
|
|
9
|
+
completeness: 'complete' | 'unknown' | 'truncated';
|
|
10
|
+
notice: string;
|
|
11
|
+
shown: number;
|
|
12
|
+
totalCount?: number;
|
|
13
|
+
}
|
|
14
|
+
/** A short present page proves completeness; a full or absent page needs an upstream count. */
|
|
15
|
+
export declare function summarizeReleaseAppearances(raw: Pick<RawRecording, 'id' | 'releases' | 'release-count'>): ReleaseAppearanceSummary;
|
|
16
|
+
//# sourceMappingURL=release-appearances.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"release-appearances.d.ts","sourceRoot":"","sources":["../../../src/services/musicbrainz/release-appearances.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,6FAA6F;AAC7F,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,UAAU,GAAG,eAAe,CAAC,GAC3D,wBAAwB,CAa1B"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** A short present page proves completeness; a full or absent page needs an upstream count. */
|
|
2
|
+
export function summarizeReleaseAppearances(raw) {
|
|
3
|
+
const cap = 25;
|
|
4
|
+
const shown = raw.releases?.length ?? 0;
|
|
5
|
+
const totalCount = raw['release-count'] ?? (raw.releases && shown < cap ? shown : undefined);
|
|
6
|
+
const completeness = totalCount === undefined ? 'unknown' : totalCount > shown ? 'truncated' : 'complete';
|
|
7
|
+
return {
|
|
8
|
+
shown,
|
|
9
|
+
cap,
|
|
10
|
+
completeness,
|
|
11
|
+
...(totalCount === undefined ? {} : { totalCount }),
|
|
12
|
+
notice: `Enumerate release appearances with musicbrainz_browse_entities (target_type=release, link.recording=${raw.id}, offset=0). Start at offset=0 because the embedded page may use a different order from browse.`,
|
|
13
|
+
};
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=release-appearances.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"release-appearances.js","sourceRoot":"","sources":["../../../src/services/musicbrainz/release-appearances.ts"],"names":[],"mappings":"AAeA,+FAA+F;AAC/F,MAAM,UAAU,2BAA2B,CACzC,GAA4D;IAE5D,MAAM,GAAG,GAAG,EAAE,CAAC;IACf,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7F,MAAM,YAAY,GAChB,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,OAAO;QACL,KAAK;QACL,GAAG;QACH,YAAY;QACZ,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;QACnD,MAAM,EAAE,uGAAuG,GAAG,CAAC,EAAE,iGAAiG;KACvN,CAAC;AACJ,CAAC"}
|