@zivue/zuuid 0.1.0 → 0.2.0

package/dist/providers/gamesdb/platform.js

@@ -0,0 +1,23 @@
+import { addAlias, addDescription, addDetail, addMedia, addTag, baseDataFromSource, finalizeData, objectPayload, stringField, valueAsString } from "../common.js";
+import { GAMESDB_PLATFORM_CATEGORY, GAMESDB_PROVIDER } from "./constants.js";
+export async function transformGamesDbPlatform(source) {
+    if (source.source.provider !== GAMESDB_PROVIDER || source.source.category !== GAMESDB_PLATFORM_CATEGORY) {
+        throw new Error(`unsupported GamesDB source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = objectPayload(source.payload);
+    const id = source.source.externalId.trim() || valueAsString(payload.id);
+    const title = stringField(payload, "name") ?? stringField(payload, "platform");
+    if (!id)
+        throw new Error("missing required GamesDB platform field: id");
+    if (!title)
+        throw new Error("missing required GamesDB platform field: name");
+    const data = await baseDataFromSource(source, GAMESDB_PROVIDER, GAMESDB_PLATFORM_CATEGORY, GAMESDB_PLATFORM_CATEGORY, id, title);
+    addAlias(data, title, "title", true, GAMESDB_PROVIDER);
+    addDescription(data, GAMESDB_PROVIDER, stringField(payload, "overview") ?? stringField(payload, "description"));
+    for (const key of ["manufacturer", "developer", "release_date", "cpu", "memory", "graphics", "sound", "display"])
+        addDetail(data, GAMESDB_PROVIDER, key, valueAsString(payload[key]));
+    addMedia(data, GAMESDB_PROVIDER, stringField(payload, "icon") ?? stringField(payload, "image") ?? stringField(payload, "console"), "image");
+    addTag(data, "platform");
+    addTag(data, "game");
+    return finalizeData(data, source);
+}

package/dist/providers/jikan/anime.d.ts

@@ -0,0 +1,2 @@
+export { transformJikanTitle as transformJikanAnime } from "./transform.js";
+//# sourceMappingURL=anime.d.ts.map

package/dist/providers/jikan/anime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anime.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/anime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/jikan/anime.js

@@ -0,0 +1 @@
+export { transformJikanTitle as transformJikanAnime } from "./transform.js";

package/dist/providers/jikan/character.d.ts

@@ -0,0 +1,2 @@
+export { transformJikanPersonish as transformJikanCharacter } from "./transform.js";
+//# sourceMappingURL=character.d.ts.map

package/dist/providers/jikan/character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,IAAI,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/jikan/character.js

@@ -0,0 +1 @@
+export { transformJikanPersonish as transformJikanCharacter } from "./transform.js";

package/dist/providers/jikan/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const JIKAN_PROVIDER = "jikan";
+export declare const JIKAN_ANIME_CATEGORY = "anime";
+export declare const JIKAN_MANGA_CATEGORY = "manga";
+export declare const JIKAN_CHARACTER_CATEGORY = "character";
+export declare const JIKAN_PERSON_CATEGORY = "person";
+export declare const JIKAN_PRODUCER_CATEGORY = "producer";
+export declare const JIKAN_MAGAZINE_CATEGORY = "magazine";
+//# sourceMappingURL=constants.d.ts.map

package/dist/providers/jikan/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,eAAO,MAAM,wBAAwB,cAAc,CAAC;AACpD,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,eAAO,MAAM,uBAAuB,aAAa,CAAC"}

package/dist/providers/jikan/constants.js

@@ -0,0 +1,7 @@
+export const JIKAN_PROVIDER = "jikan";
+export const JIKAN_ANIME_CATEGORY = "anime";
+export const JIKAN_MANGA_CATEGORY = "manga";
+export const JIKAN_CHARACTER_CATEGORY = "character";
+export const JIKAN_PERSON_CATEGORY = "person";
+export const JIKAN_PRODUCER_CATEGORY = "producer";
+export const JIKAN_MAGAZINE_CATEGORY = "magazine";

package/dist/providers/jikan/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./anime.js";
+export * from "./character.js";
+export * from "./constants.js";
+export * from "./magazine.js";
+export * from "./manga.js";
+export * from "./person.js";
+export * from "./producer.js";
+export * from "./transform.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/jikan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}

package/dist/providers/jikan/index.js

@@ -0,0 +1,8 @@
+export * from "./anime.js";
+export * from "./character.js";
+export * from "./constants.js";
+export * from "./magazine.js";
+export * from "./manga.js";
+export * from "./person.js";
+export * from "./producer.js";
+export * from "./transform.js";

package/dist/providers/jikan/magazine.d.ts

@@ -0,0 +1,2 @@
+export { transformJikanMagazine } from "./transform.js";
+//# sourceMappingURL=magazine.d.ts.map

package/dist/providers/jikan/magazine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magazine.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/magazine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/jikan/magazine.js

@@ -0,0 +1 @@
+export { transformJikanMagazine } from "./transform.js";

package/dist/providers/jikan/manga.d.ts

@@ -0,0 +1,2 @@
+export { transformJikanTitle as transformJikanManga } from "./transform.js";
+//# sourceMappingURL=manga.d.ts.map

package/dist/providers/jikan/manga.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manga.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/manga.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/jikan/manga.js

@@ -0,0 +1 @@
+export { transformJikanTitle as transformJikanManga } from "./transform.js";

package/dist/providers/jikan/person.d.ts

@@ -0,0 +1,2 @@
+export { transformJikanPersonish as transformJikanPerson } from "./transform.js";
+//# sourceMappingURL=person.d.ts.map

package/dist/providers/jikan/person.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"person.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/person.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/jikan/person.js

@@ -0,0 +1 @@
+export { transformJikanPersonish as transformJikanPerson } from "./transform.js";

package/dist/providers/jikan/producer.d.ts

@@ -0,0 +1,2 @@
+export { transformJikanProducer } from "./transform.js";
+//# sourceMappingURL=producer.d.ts.map

package/dist/providers/jikan/producer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/producer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/providers/jikan/producer.js

@@ -0,0 +1 @@
+export { transformJikanProducer } from "./transform.js";

package/dist/providers/jikan/transform.d.ts

@@ -0,0 +1,8 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export declare function transformJikan(source: SourceRecord): Promise<ZuuidData>;
+export declare function transformJikanTitle(source: SourceRecord, publicCategory?: string): Promise<ZuuidData>;
+export declare function transformJikanPersonish(source: SourceRecord, sourceCategory?: string): Promise<ZuuidData>;
+export declare function transformJikanProducer(source: SourceRecord): Promise<ZuuidData>;
+export declare function transformJikanMagazine(source: SourceRecord): Promise<ZuuidData>;
+//# sourceMappingURL=transform.d.ts.map

package/dist/providers/jikan/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/providers/jikan/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAO7E;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,SAAyB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqB3H;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,SAAyB,GAAG,OAAO,CAAC,SAAS,CAAC,CAa/H;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAerF;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAarF"}

package/dist/providers/jikan/transform.js

@@ -0,0 +1,125 @@
+import { addAlias, addDescription, addDetail, addMedia, addRelation, addTag, arrayField, baseDataFromSource, datePrefix, finalizeData, nestedString, objectPayload, stringField, stripHtml, valueAsString } from "../common.js";
+import { JIKAN_ANIME_CATEGORY, JIKAN_CHARACTER_CATEGORY, JIKAN_MAGAZINE_CATEGORY, JIKAN_MANGA_CATEGORY, JIKAN_PERSON_CATEGORY, JIKAN_PRODUCER_CATEGORY, JIKAN_PROVIDER } from "./constants.js";
+export async function transformJikan(source) {
+    if (source.source.provider !== JIKAN_PROVIDER)
+        throw new Error(`unsupported Jikan source: ${source.source.provider}:${source.source.category}`);
+    if (source.source.category === JIKAN_ANIME_CATEGORY || source.source.category === JIKAN_MANGA_CATEGORY)
+        return transformJikanTitle(source, source.source.category);
+    if (source.source.category === JIKAN_CHARACTER_CATEGORY || source.source.category === JIKAN_PERSON_CATEGORY)
+        return transformJikanPersonish(source, source.source.category);
+    if (source.source.category === JIKAN_PRODUCER_CATEGORY)
+        return transformJikanProducer(source);
+    if (source.source.category === JIKAN_MAGAZINE_CATEGORY)
+        return transformJikanMagazine(source);
+    throw new Error(`unsupported Jikan source: ${source.source.provider}:${source.source.category}`);
+}
+export async function transformJikanTitle(source, publicCategory = source.source.category) {
+    const payload = objectPayload(source.payload);
+    const id = source.source.externalId.trim() || valueAsString(payload.mal_id);
+    const title = stringField(payload, "title") ?? stringField(payload, "name") ?? stringField(payload, "title_english");
+    if (!id)
+        throw new Error("missing required Jikan field: mal_id");
+    if (!title)
+        throw new Error("missing required Jikan field: title");
+    const data = await baseDataFromSource(source, JIKAN_PROVIDER, source.source.category, publicCategory, id, title);
+    data.rating = typeof payload.score === "number" ? payload.score : undefined;
+    data.primaryDate = datePrefix(nestedString(payload, ["aired", "from"]) ?? nestedString(payload, ["published", "from"]));
+    addTitleAliases(data, payload, title);
+    addDescription(data, JIKAN_PROVIDER, stringField(payload, "synopsis") ?? stringField(payload, "background"), "en");
+    addCover(data, payload, "poster");
+    const trailer = nestedString(payload, ["trailer", "url"]) ?? (nestedString(payload, ["trailer", "youtube_id"]) ? `https://www.youtube.com/watch?v=${nestedString(payload, ["trailer", "youtube_id"])}` : undefined);
+    addMedia(data, JIKAN_PROVIDER, trailer, "trailer", "video", false);
+    for (const key of ["type", "source", "status", "rating", "season", "duration"])
+        addDetail(data, JIKAN_PROVIDER, key, stringField(payload, key));
+    for (const key of ["episodes", "chapters", "volumes", "rank", "popularity", "members", "favorites", "scored_by"])
+        addDetail(data, JIKAN_PROVIDER, key, valueAsString(payload[key]));
+    for (const key of ["genres", "themes", "demographics"])
+        addNamedTags(data, payload, key);
+    await addNamedRelations(data, payload, "studios", "studio", "organization");
+    await addNamedRelations(data, payload, "producers", "producer", "organization");
+    await addNamedRelations(data, payload, "authors", "author", "person");
+    return finalizeData(data, source);
+}
+export async function transformJikanPersonish(source, sourceCategory = source.source.category) {
+    const payload = objectPayload(source.payload);
+    const id = source.source.externalId.trim() || valueAsString(payload.mal_id);
+    const title = stringField(payload, "title") ?? stringField(payload, "name") ?? stringField(payload, "title_english");
+    if (!id)
+        throw new Error("missing required Jikan field: mal_id");
+    if (!title)
+        throw new Error("missing required Jikan field: name");
+    const data = await baseDataFromSource(source, JIKAN_PROVIDER, sourceCategory, "person", id, title);
+    data.primaryDate = datePrefix(stringField(payload, "birthday"));
+    addTitleAliases(data, payload, title);
+    addDescription(data, JIKAN_PROVIDER, stringField(payload, "about"), "en");
+    addCover(data, payload, "profile");
+    for (const key of ["favorites", "given_name", "family_name", "alternate_names"])
+        addDetail(data, JIKAN_PROVIDER, key, valueAsString(payload[key]));
+    return finalizeData(data, source);
+}
+export async function transformJikanProducer(source) {
+    const payload = objectPayload(source.payload);
+    const id = source.source.externalId.trim() || valueAsString(payload.mal_id);
+    const title = stringField(payload, "title") ?? stringField(payload, "name");
+    if (!id)
+        throw new Error("missing required Jikan producer field: mal_id");
+    if (!title)
+        throw new Error("missing required Jikan producer field: name");
+    const data = await baseDataFromSource(source, JIKAN_PROVIDER, JIKAN_PRODUCER_CATEGORY, "organization", id, title);
+    data.primaryDate = datePrefix(stringField(payload, "established"));
+    addTitleAliases(data, payload, title);
+    addDescription(data, JIKAN_PROVIDER, stringField(payload, "about"), "en");
+    addCover(data, payload, "logo");
+    for (const key of ["count", "favorites", "established"])
+        addDetail(data, JIKAN_PROVIDER, key, valueAsString(payload[key]));
+    addTag(data, "producer");
+    addTag(data, "anime");
+    return finalizeData(data, source);
+}
+export async function transformJikanMagazine(source) {
+    const payload = objectPayload(source.payload);
+    const id = source.source.externalId.trim() || valueAsString(payload.mal_id);
+    const title = stringField(payload, "title") ?? stringField(payload, "name");
+    if (!id)
+        throw new Error("missing required Jikan magazine field: mal_id");
+    if (!title)
+        throw new Error("missing required Jikan magazine field: name");
+    const data = await baseDataFromSource(source, JIKAN_PROVIDER, JIKAN_MAGAZINE_CATEGORY, JIKAN_MAGAZINE_CATEGORY, id, title);
+    addTitleAliases(data, payload, title);
+    addDescription(data, JIKAN_PROVIDER, stringField(payload, "about"), "en");
+    for (const key of ["count", "favorites"])
+        addDetail(data, JIKAN_PROVIDER, key, valueAsString(payload[key]));
+    addTag(data, "magazine");
+    addTag(data, "manga");
+    return finalizeData(data, source);
+}
+function addTitleAliases(data, payload, title) {
+    addAlias(data, title, "title", true, JIKAN_PROVIDER);
+    for (const [key, lang] of [["title_english", "en"], ["title_japanese", "ja"], ["name_kanji", "ja"]]) {
+        const value = stringField(payload, key);
+        if (value !== title)
+            addAlias(data, value, "title", false, JIKAN_PROVIDER, lang);
+    }
+    for (const key of ["title_synonyms", "nicknames", "alternate_names"]) {
+        for (const value of arrayField(payload, key))
+            if (typeof value === "string" && value !== title)
+                addAlias(data, value, "alternative", false, JIKAN_PROVIDER);
+    }
+}
+function addCover(data, payload, category) {
+    addMedia(data, JIKAN_PROVIDER, nestedString(payload, ["images", "jpg", "large_image_url"]) ?? nestedString(payload, ["images", "jpg", "image_url"]) ?? nestedString(payload, ["images", "webp", "large_image_url"]) ?? nestedString(payload, ["images", "webp", "image_url"]), category);
+}
+function addNamedTags(data, payload, key) {
+    for (const value of arrayField(payload, key))
+        if (value && typeof value === "object" && !Array.isArray(value))
+            addTag(data, stringField(value, "name"));
+}
+async function addNamedRelations(data, payload, key, relation, category) {
+    let index = 0;
+    for (const value of arrayField(payload, key)) {
+        if (value && typeof value === "object" && !Array.isArray(value)) {
+            await addRelation(data, JIKAN_PROVIDER, category, valueAsString(value.mal_id), relation, stringField(value, "name"), { order: index });
+            index += 1;
+        }
+    }
+}

package/dist/providers/musicbrainz/artist.d.ts

@@ -0,0 +1,4 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export declare function transformMusicBrainzArtist(source: SourceRecord): Promise<ZuuidData>;
+//# sourceMappingURL=artist.d.ts.map

package/dist/providers/musicbrainz/artist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artist.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/artist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAuBzF"}

package/dist/providers/musicbrainz/artist.js

@@ -0,0 +1,28 @@
+import { addDetail, addTag, baseDataFromSource, finalizeData, nestedString, stringField } from "../common.js";
+import { MUSICBRAINZ_ARTIST_CATEGORY, MUSICBRAINZ_PROVIDER } from "./constants.js";
+import { addAreaDetails, addLifeSpanDetails, addMusicBrainzAliases, addMusicBrainzDescription, addMusicBrainzTags, musicBrainzId, musicBrainzPayload, requireMusicBrainzTitle } from "./helpers.js";
+export async function transformMusicBrainzArtist(source) {
+    if (source.source.provider !== MUSICBRAINZ_PROVIDER || source.source.category !== MUSICBRAINZ_ARTIST_CATEGORY) {
+        throw new Error(`unsupported MusicBrainz source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = musicBrainzPayload(source.payload);
+    const id = musicBrainzId(payload, source.source.externalId);
+    const title = requireMusicBrainzTitle(payload, "name");
+    if (!id)
+        throw new Error("missing required MusicBrainz artist field: id");
+    if (!title)
+        throw new Error("missing required MusicBrainz artist field: name");
+    const data = await baseDataFromSource(source, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_ARTIST_CATEGORY, MUSICBRAINZ_ARTIST_CATEGORY, id, title);
+    data.primaryDate = nestedString(payload, ["life-span", "begin"]);
+    addMusicBrainzAliases(data, payload, title);
+    addMusicBrainzDescription(data, payload);
+    addDetail(data, MUSICBRAINZ_PROVIDER, "sort_name", stringField(payload, "sort-name"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "type", stringField(payload, "type"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "country", stringField(payload, "country"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "gender", stringField(payload, "gender"));
+    addLifeSpanDetails(data, payload);
+    addAreaDetails(data, payload);
+    addMusicBrainzTags(data, payload);
+    addTag(data, "artist");
+    return finalizeData(data, source);
+}

package/dist/providers/musicbrainz/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const MUSICBRAINZ_PROVIDER = "musicbrainz";
+export declare const MUSICBRAINZ_RELEASE_CATEGORY = "release";
+export declare const MUSICBRAINZ_RELEASE_GROUP_CATEGORY = "release-group";
+export declare const MUSICBRAINZ_RECORDING_CATEGORY = "recording";
+export declare const MUSICBRAINZ_ARTIST_CATEGORY = "artist";
+export declare const MUSICBRAINZ_LABEL_CATEGORY = "label";
+export declare const MUSICBRAINZ_WORK_CATEGORY = "work";
+export declare const MUSICBRAINZ_COVER_ART_BASE_URL = "https://coverartarchive.org/release";
+export declare const MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL = "https://coverartarchive.org/release-group";
+//# sourceMappingURL=constants.d.ts.map

package/dist/providers/musicbrainz/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,4BAA4B,YAAY,CAAC;AACtD,eAAO,MAAM,kCAAkC,kBAAkB,CAAC;AAClE,eAAO,MAAM,8BAA8B,cAAc,CAAC;AAC1D,eAAO,MAAM,2BAA2B,WAAW,CAAC;AACpD,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAClD,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AACpF,eAAO,MAAM,4CAA4C,8CAA8C,CAAC"}

package/dist/providers/musicbrainz/constants.js

@@ -0,0 +1,9 @@
+export const MUSICBRAINZ_PROVIDER = "musicbrainz";
+export const MUSICBRAINZ_RELEASE_CATEGORY = "release";
+export const MUSICBRAINZ_RELEASE_GROUP_CATEGORY = "release-group";
+export const MUSICBRAINZ_RECORDING_CATEGORY = "recording";
+export const MUSICBRAINZ_ARTIST_CATEGORY = "artist";
+export const MUSICBRAINZ_LABEL_CATEGORY = "label";
+export const MUSICBRAINZ_WORK_CATEGORY = "work";
+export const MUSICBRAINZ_COVER_ART_BASE_URL = "https://coverartarchive.org/release";
+export const MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL = "https://coverartarchive.org/release-group";

package/dist/providers/musicbrainz/helpers.d.ts

@@ -0,0 +1,15 @@
+import type { ZuuidData } from "../../entity.js";
+import type { JsonValue } from "../../types.js";
+export declare function musicBrainzPayload(value: JsonValue): Record<string, JsonValue>;
+export declare function musicBrainzId(payload: Record<string, JsonValue>, externalId: string): string | undefined;
+export declare function requireMusicBrainzTitle(payload: Record<string, JsonValue>, field?: string): string | undefined;
+export declare function addMusicBrainzAliases(data: ZuuidData, payload: Record<string, JsonValue>, primary: string): void;
+export declare function addMusicBrainzDescription(data: ZuuidData, payload: Record<string, JsonValue>): void;
+export declare function addMusicBrainzTags(data: ZuuidData, payload: Record<string, JsonValue>): void;
+export declare function artistCredit(payload: Record<string, JsonValue>): string | undefined;
+export declare function addArtistCreditDetail(data: ZuuidData, payload: Record<string, JsonValue>): void;
+export declare function addLifeSpanDetails(data: ZuuidData, payload: Record<string, JsonValue>): void;
+export declare function nestedRaw(payload: Record<string, JsonValue>, path: string[]): JsonValue | undefined;
+export declare function addAreaDetails(data: ZuuidData, payload: Record<string, JsonValue>): void;
+export declare function addRelationListDetail(data: ZuuidData, payload: Record<string, JsonValue>, key: string, detailKey: string): void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/providers/musicbrainz/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAE9E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExG;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,SAAU,GAAG,MAAM,GAAG,SAAS,CAE/G;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAOhH;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAGnG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAM5F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAOnF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAE/F;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAI5F;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,CAOnG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAIxF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAM/H"}

package/dist/providers/musicbrainz/helpers.js

@@ -0,0 +1,71 @@
+import { addAlias, addDescription, addDetail, addTag, arrayField, nestedString, objectPayload, stringField, valueAsString } from "../common.js";
+import { MUSICBRAINZ_PROVIDER } from "./constants.js";
+export function musicBrainzPayload(value) {
+    return objectPayload(value);
+}
+export function musicBrainzId(payload, externalId) {
+    return externalId.trim() || stringField(payload, "id");
+}
+export function requireMusicBrainzTitle(payload, field = "title") {
+    return stringField(payload, field) ?? stringField(payload, "name");
+}
+export function addMusicBrainzAliases(data, payload, primary) {
+    addAlias(data, primary, "title", true, MUSICBRAINZ_PROVIDER);
+    for (const alias of arrayField(payload, "aliases")) {
+        if (!alias || typeof alias !== "object" || Array.isArray(alias))
+            continue;
+        const object = alias;
+        addAlias(data, stringField(object, "name"), stringField(object, "type") ?? "alias", false, MUSICBRAINZ_PROVIDER, stringField(object, "locale"));
+    }
+}
+export function addMusicBrainzDescription(data, payload) {
+    addDescription(data, MUSICBRAINZ_PROVIDER, stringField(payload, "disambiguation"));
+    addDescription(data, MUSICBRAINZ_PROVIDER, stringField(payload, "annotation"));
+}
+export function addMusicBrainzTags(data, payload) {
+    for (const key of ["genres", "tags"]) {
+        for (const item of arrayField(payload, key)) {
+            if (item && typeof item === "object" && !Array.isArray(item))
+                addTag(data, stringField(item, "name"));
+        }
+    }
+}
+export function artistCredit(payload) {
+    const names = arrayField(payload, "artist-credit").map((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return undefined;
+        const object = item;
+        return stringField(object, "name") ?? nestedString(object, ["artist", "name"]);
+    }).filter((value) => !!value);
+    return names.length ? names.join(", ") : undefined;
+}
+export function addArtistCreditDetail(data, payload) {
+    addDetail(data, MUSICBRAINZ_PROVIDER, "artist_credit", artistCredit(payload));
+}
+export function addLifeSpanDetails(data, payload) {
+    addDetail(data, MUSICBRAINZ_PROVIDER, "begin_date", nestedString(payload, ["life-span", "begin"]));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "end_date", nestedString(payload, ["life-span", "end"]));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "ended", valueAsString(nestedRaw(payload, ["life-span", "ended"])));
+}
+export function nestedRaw(payload, path) {
+    let current = payload;
+    for (const key of path) {
+        if (!current || typeof current !== "object" || Array.isArray(current))
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+export function addAreaDetails(data, payload) {
+    addDetail(data, MUSICBRAINZ_PROVIDER, "area", nestedString(payload, ["area", "name"]));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "begin_area", nestedString(payload, ["begin-area", "name"]));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "end_area", nestedString(payload, ["end-area", "name"]));
+}
+export function addRelationListDetail(data, payload, key, detailKey) {
+    const values = arrayField(payload, key).map((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item))
+            return undefined;
+        return stringField(item, "title") ?? stringField(item, "name");
+    }).filter((value) => !!value);
+    addDetail(data, MUSICBRAINZ_PROVIDER, detailKey, values.length ? values.join(", ") : undefined);
+}

package/dist/providers/musicbrainz/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./artist.js";
+export * from "./constants.js";
+export * from "./label.js";
+export * from "./recording.js";
+export * from "./release.js";
+export * from "./release-group.js";
+export * from "./work.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/musicbrainz/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/dist/providers/musicbrainz/index.js

@@ -0,0 +1,7 @@
+export * from "./artist.js";
+export * from "./constants.js";
+export * from "./label.js";
+export * from "./recording.js";
+export * from "./release.js";
+export * from "./release-group.js";
+export * from "./work.js";

package/dist/providers/musicbrainz/label.d.ts

@@ -0,0 +1,4 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export declare function transformMusicBrainzLabel(source: SourceRecord): Promise<ZuuidData>;
+//# sourceMappingURL=label.d.ts.map

package/dist/providers/musicbrainz/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAuBxF"}

package/dist/providers/musicbrainz/label.js

@@ -0,0 +1,28 @@
+import { addDetail, addTag, baseDataFromSource, finalizeData, nestedString, stringField, valueAsString } from "../common.js";
+import { MUSICBRAINZ_LABEL_CATEGORY, MUSICBRAINZ_PROVIDER } from "./constants.js";
+import { addAreaDetails, addLifeSpanDetails, addMusicBrainzAliases, addMusicBrainzDescription, addMusicBrainzTags, musicBrainzId, musicBrainzPayload, requireMusicBrainzTitle } from "./helpers.js";
+export async function transformMusicBrainzLabel(source) {
+    if (source.source.provider !== MUSICBRAINZ_PROVIDER || source.source.category !== MUSICBRAINZ_LABEL_CATEGORY) {
+        throw new Error(`unsupported MusicBrainz source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = musicBrainzPayload(source.payload);
+    const id = musicBrainzId(payload, source.source.externalId);
+    const title = requireMusicBrainzTitle(payload, "name");
+    if (!id)
+        throw new Error("missing required MusicBrainz label field: id");
+    if (!title)
+        throw new Error("missing required MusicBrainz label field: name");
+    const data = await baseDataFromSource(source, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_LABEL_CATEGORY, MUSICBRAINZ_LABEL_CATEGORY, id, title);
+    data.primaryDate = nestedString(payload, ["life-span", "begin"]);
+    addMusicBrainzAliases(data, payload, title);
+    addMusicBrainzDescription(data, payload);
+    addDetail(data, MUSICBRAINZ_PROVIDER, "sort_name", stringField(payload, "sort-name"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "type", stringField(payload, "type"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "country", stringField(payload, "country"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "label_code", valueAsString(payload["label-code"]));
+    addLifeSpanDetails(data, payload);
+    addAreaDetails(data, payload);
+    addMusicBrainzTags(data, payload);
+    addTag(data, "label");
+    return finalizeData(data, source);
+}

package/dist/providers/musicbrainz/recording.d.ts

@@ -0,0 +1,4 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export declare function transformMusicBrainzRecording(source: SourceRecord): Promise<ZuuidData>;
+//# sourceMappingURL=recording.d.ts.map

package/dist/providers/musicbrainz/recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/recording.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAsB5F"}

package/dist/providers/musicbrainz/recording.js

@@ -0,0 +1,41 @@
+import { addDetail, addRelation, arrayField, baseDataFromSource, finalizeData, stringField, valueAsString } from "../common.js";
+import { MUSICBRAINZ_ARTIST_CATEGORY, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RECORDING_CATEGORY } from "./constants.js";
+import { addArtistCreditDetail, addMusicBrainzDescription, addMusicBrainzTags, musicBrainzId, musicBrainzPayload, requireMusicBrainzTitle } from "./helpers.js";
+export async function transformMusicBrainzRecording(source) {
+    if (source.source.provider !== MUSICBRAINZ_PROVIDER || source.source.category !== MUSICBRAINZ_RECORDING_CATEGORY) {
+        throw new Error(`unsupported MusicBrainz source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = musicBrainzPayload(source.payload);
+    const id = musicBrainzId(payload, source.source.externalId);
+    const title = requireMusicBrainzTitle(payload);
+    if (!id)
+        throw new Error("missing required MusicBrainz recording field: id");
+    if (!title)
+        throw new Error("missing required MusicBrainz recording field: title");
+    const data = await baseDataFromSource(source, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RECORDING_CATEGORY, MUSICBRAINZ_RECORDING_CATEGORY, id, title);
+    data.primaryDate = stringField(payload, "first-release-date");
+    addDetail(data, MUSICBRAINZ_PROVIDER, "first_release_date", stringField(payload, "first-release-date"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "length_ms", valueAsString(payload.length));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "video", valueAsString(payload.video));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "isrcs", arrayField(payload, "isrcs").filter((value) => typeof value === "string"));
+    for (const isrc of arrayField(payload, "isrcs"))
+        if (typeof isrc === "string")
+            data.externalIds.push({ source: "isrc", category: MUSICBRAINZ_RECORDING_CATEGORY, value: isrc });
+    addArtistCreditDetail(data, payload);
+    await addArtistCreditRelations(data, payload);
+    addMusicBrainzDescription(data, payload);
+    addMusicBrainzTags(data, payload);
+    return finalizeData(data, source);
+}
+async function addArtistCreditRelations(data, payload) {
+    let index = 0;
+    for (const credit of arrayField(payload, "artist-credit")) {
+        if (!credit || typeof credit !== "object" || Array.isArray(credit))
+            continue;
+        const artist = credit.artist;
+        if (!artist || typeof artist !== "object" || Array.isArray(artist))
+            continue;
+        await addRelation(data, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_ARTIST_CATEGORY, stringField(artist, "id"), "performed_by", stringField(artist, "name"), { order: index });
+        index += 1;
+    }
+}

package/dist/providers/musicbrainz/release-group.d.ts

@@ -0,0 +1,7 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export type MusicBrainzReleaseGroupTransformOptions = {
+    coverArtBaseUrl?: string | null;
+};
+export declare function transformMusicBrainzReleaseGroup(source: SourceRecord, options?: MusicBrainzReleaseGroupTransformOptions): Promise<ZuuidData>;
+//# sourceMappingURL=release-group.d.ts.map

package/dist/providers/musicbrainz/release-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-group.d.ts","sourceRoot":"","sources":["../../../src/providers/musicbrainz/release-group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKpD,MAAM,MAAM,uCAAuC,GAAG;IACpD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,uCAA4C,GACpD,OAAO,CAAC,SAAS,CAAC,CAsBpB"}

package/dist/providers/musicbrainz/release-group.js

@@ -0,0 +1,28 @@
+import { addDetail, addMedia, arrayField, baseDataFromSource, finalizeData, stringField, valueAsString } from "../common.js";
+import { MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RELEASE_GROUP_CATEGORY, MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL } from "./constants.js";
+import { addArtistCreditDetail, addMusicBrainzDescription, addMusicBrainzTags, musicBrainzId, musicBrainzPayload, requireMusicBrainzTitle } from "./helpers.js";
+export async function transformMusicBrainzReleaseGroup(source, options = {}) {
+    if (source.source.provider !== MUSICBRAINZ_PROVIDER || source.source.category !== MUSICBRAINZ_RELEASE_GROUP_CATEGORY) {
+        throw new Error(`unsupported MusicBrainz source: ${source.source.provider}:${source.source.category}`);
+    }
+    const payload = musicBrainzPayload(source.payload);
+    const id = musicBrainzId(payload, source.source.externalId);
+    const title = requireMusicBrainzTitle(payload);
+    if (!id)
+        throw new Error("missing required MusicBrainz release-group field: id");
+    if (!title)
+        throw new Error("missing required MusicBrainz release-group field: title");
+    const data = await baseDataFromSource(source, MUSICBRAINZ_PROVIDER, MUSICBRAINZ_RELEASE_GROUP_CATEGORY, "release_group", id, title);
+    data.primaryDate = stringField(payload, "first-release-date");
+    addDetail(data, MUSICBRAINZ_PROVIDER, "first_release_date", stringField(payload, "first-release-date"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "primary_type", stringField(payload, "primary-type"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "secondary_types", arrayField(payload, "secondary-types").filter((value) => typeof value === "string"));
+    addDetail(data, MUSICBRAINZ_PROVIDER, "release_count", valueAsString(payload["release-count"]));
+    addArtistCreditDetail(data, payload);
+    addMusicBrainzDescription(data, payload);
+    addMusicBrainzTags(data, payload);
+    const baseUrl = options.coverArtBaseUrl === undefined ? MUSICBRAINZ_RELEASE_GROUP_COVER_ART_BASE_URL : options.coverArtBaseUrl;
+    if (baseUrl)
+        addMedia(data, MUSICBRAINZ_PROVIDER, `${baseUrl.replace(/\/$/, "")}/${id}/front`, "cover");
+    return finalizeData(data, source);
+}

package/dist/providers/musicbrainz/release.d.ts

@@ -0,0 +1,7 @@
+import type { ZuuidData } from "../../entity.js";
+import type { SourceRecord } from "../../source.js";
+export type MusicBrainzTransformOptions = {
+    coverArtBaseUrl?: string | null;
+};
+export declare function transformMusicBrainzRelease(source: SourceRecord, options?: MusicBrainzTransformOptions): Promise<ZuuidData>;
+//# sourceMappingURL=release.d.ts.map