ddex-json-codec 0.1.1 → 0.3.0

package/README.md

@@ -85,6 +85,7 @@ interface DdexMessage {
   messageHeader: MessageHeader;
   updateIndicator?: string;
   resourceList: SoundRecording[];
+  imageList?: Image[];
   releaseList: Release[];
   dealList: ReleaseDeal[];
   partyList?: Party[];              // ERN 4.x only
@@ -95,9 +96,11 @@ interface DdexMessage {
 Exported types:
 
 `DdexMessage`, `ErnVersion`, `ErnMajorVersion`, `MessageHeader`, `MessageParty`,
-`SoundRecording`, `Release`, `TrackRelease`, `ResourceGroup`, `ReleaseResourceReference`,
+`SoundRecording`, `TechnicalSoundRecordingDetails`,
+`Image`, `ImageId`, `ImageDetailsByTerritory`, `TechnicalImageDetails`, `FileDetails`, `HashSum`,
+`Release`, `TrackRelease`, `ResourceGroup`, `ReleaseResourceReference`,
 `ReleaseDeal`, `Deal`, `DealTerms`, `Usage`,
-`Party`, `Artist`, `DisplayArtist`, `ResourceContributor`, `IndirectResourceContributor`, `Contributor`,
+`Party`, `Artist`, `ArtistRole`, `DisplayArtist`, `ResourceContributor`, `IndirectResourceContributor`, `Contributor`,
 `TextWithAttribute`, `Genre`, `PLine`, `CLine`, `Title`, `DisplayTitle`
 
 ## License

package/dist/index.d.mts

@@ -45,13 +45,21 @@ interface PartyName {
   fullNameIndexed?: string;
   languageAndScriptCode?: string;
 }
+interface ArtistRole {
+  role: string;
+  /** UserDefined時の属性 */
+  namespace?: string;
+  userDefinedValue?: string;
+}
 interface Artist {
-  /** 解決済みの名前（3.8系: FullNameから直接取得、4系: PartyListから解決） */
+  /** 解決済みのデフォルト名（3.8系: FullNameから直接取得、4系: PartyListの最初のFullName） */
   name: string;
+  /** 4系のみ: 多言語名（PartyListのPartyName[]をそのまま保持） */
+  names?: PartyName[];
   /** 4系のみ: 元の参照ID（ラウンドトリップ用） */
   partyReference?: string;
   partyId?: string[];
-  roles?: string[];
+  roles?: ArtistRole[];
 }
 interface DisplayArtist {
   artist: Artist;
@@ -61,6 +69,7 @@ interface ResourceContributor {
   name: string;
   role: string;
   sequenceNumber?: number;
+  instrumentType?: string;
   /** UserDefined時の属性 */
   roleNamespace?: string;
   roleUserDefinedValue?: string;
@@ -79,26 +88,67 @@ interface Contributor {
   sequenceNumber?: number;
 }
 //#endregion
+//#region src/types/image.d.ts
+interface ImageBase {
+  resourceReference: string;
+  type?: string;
+  imageId?: ImageId;
+}
+interface Image38 extends ImageBase {
+  detailsByTerritory?: ImageDetailsByTerritory[];
+}
+interface Image4 extends ImageBase {
+  parentalWarningType?: string;
+  technicalDetails?: TechnicalImageDetails;
+}
+type Image = Image38 | Image4;
+interface ImageId {
+  proprietaryId?: string;
+  proprietaryIdNamespace?: string;
+}
+interface ImageDetailsByTerritory {
+  territoryCode: string[];
+  parentalWarningType?: string;
+  technicalDetails?: TechnicalImageDetails;
+}
+interface TechnicalImageDetails {
+  technicalResourceDetailsReference?: string;
+  imageCodecType?: string;
+  imageHeight?: number;
+  imageWidth?: number;
+  file?: FileDetails;
+}
+interface FileDetails {
+  fileName?: string;
+  uri?: string;
+  hashSum?: HashSum;
+}
+interface HashSum {
+  algorithm?: string;
+  hashSumValue?: string;
+}
+//#endregion
 //#region src/types/sound-recording.d.ts
-interface SoundRecording {
+interface SoundRecordingBase {
   resourceReference: string;
   type?: string;
   soundRecordingId?: SoundRecordingId;
-  referenceTitle?: ReferenceTitle$1;
   displayArtists: DisplayArtist[];
   duration?: string;
   creationDate?: string;
   languageOfPerformance?: string;
   pLine?: PLine;
-  /** 3.8系: territory別の詳細 */
+}
+interface SoundRecording38 extends SoundRecordingBase {
+  referenceTitle?: ReferenceTitle$1;
   detailsByTerritory?: SoundRecordingDetailsByTerritory[];
-  /** 4系: フラットなタイトルテキスト */
+}
+interface SoundRecording4 extends SoundRecordingBase {
   displayTitleText?: string;
-  /** 4系: 複数のDisplayTitle（territory+lang属性） */
   displayTitles?: DisplayTitle[];
-  /** 4系: PartyReference参照のContributor */
   contributors?: Contributor[];
 }
+type SoundRecording = SoundRecording38 | SoundRecording4;
 interface SoundRecordingId {
   isrc?: string;
   catalogNumber?: string;
@@ -107,9 +157,22 @@ interface ReferenceTitle$1 {
   titleText: string;
   subTitle?: string;
 }
+interface TechnicalSoundRecordingDetails {
+  technicalResourceDetailsReference?: string;
+  audioCodecType?: string;
+  bitRate?: number;
+  bitRateUnit?: string;
+  bitsPerSample?: number;
+  numberOfChannels?: number;
+  samplingRate?: number;
+  samplingRateUnit?: string;
+  isPreview?: boolean;
+  file?: FileDetails;
+}
 interface SoundRecordingDetailsByTerritory {
   territoryCode: string[];
   displayArtists?: DisplayArtist[];
+  displayArtistName?: string;
   titles?: Title[];
   labelName?: string;
   pLine?: PLine;
@@ -118,31 +181,34 @@ interface SoundRecordingDetailsByTerritory {
   sequenceNumber?: number;
   resourceContributors?: ResourceContributor[];
   indirectResourceContributors?: IndirectResourceContributor[];
+  technicalDetails?: TechnicalSoundRecordingDetails[];
 }
 //#endregion
 //#region src/types/release.d.ts
-interface Release {
+interface ReleaseBase {
   releaseReference: string;
   releaseType?: string;
   releaseId?: ReleaseId;
-  referenceTitle?: ReferenceTitle;
   displayArtists: DisplayArtist[];
   releaseResourceReferences?: ReleaseResourceReference[];
-  resourceGroup?: ResourceGroup;
   duration?: string;
   pLine?: PLine;
   cLine?: CLine;
-  /** 3.8系: territory別の詳細 */
+}
+interface Release38 extends ReleaseBase {
+  referenceTitle?: ReferenceTitle;
   detailsByTerritory?: ReleaseDetailsByTerritory[];
-  /** 4系: フラットなタイトルテキスト */
+  resourceGroup?: ResourceGroup;
+}
+interface Release4 extends ReleaseBase {
   displayTitleText?: string;
-  /** 4系: 複数のDisplayTitle（territory+lang属性） */
   displayTitles?: DisplayTitle[];
-  /** 4系: ReleaseLabelReference（PartyRef値） */
   releaseLabelReferences?: string[];
   genre?: Genre;
   parentalWarningType?: string;
+  resourceGroup?: ResourceGroup;
 }
+type Release = Release38 | Release4;
 interface ReferenceTitle {
   titleText: string;
   subTitle?: string;
@@ -153,6 +219,7 @@ interface ReleaseId {
   isrc?: string;
   gridOrIcpn?: string;
   catalogNumber?: string;
+  catalogNumberNamespace?: string;
   proprietaryId?: string;
 }
 interface ReleaseResourceReference {
@@ -176,9 +243,7 @@ interface TrackRelease {
   referenceTitle?: ReferenceTitle;
   displayArtists?: DisplayArtist[];
   releaseResourceReference: string;
-  /** 4系: 複数のDisplayTitle */
   displayTitles?: DisplayTitle[];
-  /** 4系: ReleaseLabelReference */
   releaseLabelReferences?: string[];
   genre?: Genre;
 }
@@ -231,7 +296,9 @@ interface PriceInformation {
 /**
  * パッチレベルまでのバージョン（namespace URIから検出）
  */
-type ErnVersion = '3.8' | '3.8.1' | '3.8.2' | '3.8.3' | '4.1' | '4.1.1' | '4.2' | '4.3' | '4.3.1' | '4.3.2';
+type ErnVersion38 = '3.8' | '3.8.1' | '3.8.2' | '3.8.3';
+type ErnVersion4 = '4.1' | '4.1.1' | '4.2' | '4.3' | '4.3.1' | '4.3.2';
+type ErnVersion = ErnVersion38 | ErnVersion4;
 /**
  * 変換ロジックの分岐用（メジャー系統のみ）
  */
@@ -250,18 +317,27 @@ interface MessageHeader {
   messageRecipient: MessageParty;
   messageCreatedDateTime: string;
 }
-interface DdexMessage {
-  ernVersion: ErnVersion;
+interface DdexMessageBase {
   messageHeader: MessageHeader;
   updateIndicator?: string;
-  resourceList: SoundRecording[];
-  releaseList: Release[];
+}
+interface DdexMessage38 extends DdexMessageBase {
+  ernVersion: ErnVersion38;
+  resourceList: SoundRecording38[];
+  imageList?: Image38[];
+  releaseList: Release38[];
+  dealList: ReleaseDeal[];
+}
+interface DdexMessage4 extends DdexMessageBase {
+  ernVersion: ErnVersion4;
+  resourceList: SoundRecording4[];
+  imageList?: Image4[];
+  releaseList: Release4[];
   dealList: ReleaseDeal[];
-  /** 4系のみ: PartyList（ラウンドトリップ用に保持） */
   partyList?: Party[];
-  /** 4系のみ: TrackRelease */
   trackReleaseList?: TrackRelease[];
 }
+type DdexMessage = DdexMessage38 | DdexMessage4;
 //#endregion
 //#region src/converter/xml-to-json/index.d.ts
 /**
@@ -287,4 +363,4 @@ declare function jsonToXml(message: DdexMessage, version?: ErnVersion): string;
  */
 declare function detectVersion(xml: string): ErnVersion;
 //#endregion
-export { type Artist, type CLine, type Contributor, type DdexMessage, type Deal, type DealTerms, type DisplayArtist, type DisplayTitle, type ErnMajorVersion, type ErnVersion, type Genre, type IndirectResourceContributor, type MessageHeader, type MessageParty, type PLine, type Party, type Release, type ReleaseDeal, type ReleaseResourceReference, type ResourceContributor, type ResourceGroup, type SoundRecording, type TextWithAttribute, type Title, type TrackRelease, type Usage, detectVersion, jsonToXml, xmlToJson };
+export { type Artist, type ArtistRole, type CLine, type Contributor, type DdexMessage, type DdexMessage38, type DdexMessage4, type DdexMessageBase, type Deal, type DealTerms, type DisplayArtist, type DisplayTitle, type ErnMajorVersion, type ErnVersion, type ErnVersion38, type ErnVersion4, type FileDetails, type Genre, type HashSum, type Image, type Image38, type Image4, type ImageBase, type ImageDetailsByTerritory, type ImageId, type IndirectResourceContributor, type MessageHeader, type MessageParty, type PLine, type Party, type PartyName, type Release, type Release38, type Release4, type ReleaseBase, type ReleaseDeal, type ReleaseDetailsByTerritory, type ReleaseId, type ReleaseResourceReference, type ResourceContributor, type ResourceGroup, type SoundRecording, type SoundRecording38, type SoundRecording4, type SoundRecordingBase, type SoundRecordingDetailsByTerritory, type TechnicalImageDetails, type TechnicalSoundRecordingDetails, type TextWithAttribute, type Title, type TrackRelease, type Usage, detectVersion, jsonToXml, xmlToJson };

package/dist/index.mjs

@@ -146,6 +146,7 @@ var Ern38Converter = class {
 			messageHeader: this.parseMessageHeader(root.MessageHeader),
 			updateIndicator: root.UpdateIndicator ?? void 0,
 			resourceList: this.parseSoundRecordings(root.ResourceList),
+			imageList: this.parseImages(root.ResourceList),
 			releaseList: this.parseReleases(root.ReleaseList),
 			dealList: this.parseDealList(root.DealList)
 		};
@@ -209,6 +210,7 @@ var Ern38Converter = class {
 		return {
 			territoryCode: ensureArray(raw.TerritoryCode),
 			displayArtists: this.parseDisplayArtists(raw.DisplayArtist),
+			displayArtistName: Array.isArray(raw.DisplayArtistName) ? raw.DisplayArtistName[0] : raw.DisplayArtistName ?? void 0,
 			titles: this.parseTitles(raw.Title),
 			labelName: raw.LabelName ?? void 0,
 			pLine: raw.PLine ? this.parsePLine(ensureArray(raw.PLine)[0]) : void 0,
@@ -216,7 +218,75 @@ var Ern38Converter = class {
 			parentalWarningType: raw.ParentalWarningType ?? void 0,
 			sequenceNumber: raw.SequenceNumber ? Number(raw.SequenceNumber) : void 0,
 			resourceContributors: this.parseResourceContributors(raw.ResourceContributor),
-			indirectResourceContributors: this.parseIndirectResourceContributors(raw.IndirectResourceContributor)
+			indirectResourceContributors: this.parseIndirectResourceContributors(raw.IndirectResourceContributor),
+			technicalDetails: raw.TechnicalSoundRecordingDetails ? ensureArray(raw.TechnicalSoundRecordingDetails).map((td) => this.parseTechnicalSoundRecordingDetails(td)) : void 0
+		};
+	}
+	parseTechnicalSoundRecordingDetails(raw) {
+		const bitRate = raw.BitRate;
+		const samplingRate = raw.SamplingRate;
+		return {
+			technicalResourceDetailsReference: raw.TechnicalResourceDetailsReference ?? void 0,
+			audioCodecType: raw.AudioCodecType ?? void 0,
+			bitRate: bitRate ? Number(typeof bitRate === "string" ? bitRate : bitRate["#text"]) : void 0,
+			bitRateUnit: typeof bitRate === "object" ? bitRate["@_UnitOfMeasure"] ?? void 0 : void 0,
+			bitsPerSample: raw.BitsPerSample ? Number(raw.BitsPerSample) : void 0,
+			numberOfChannels: raw.NumberOfChannels ? Number(raw.NumberOfChannels) : void 0,
+			samplingRate: samplingRate ? Number(typeof samplingRate === "string" ? samplingRate : samplingRate["#text"]) : void 0,
+			samplingRateUnit: typeof samplingRate === "object" ? samplingRate["@_UnitOfMeasure"] ?? void 0 : void 0,
+			isPreview: raw.IsPreview === "true" ? true : raw.IsPreview === "false" ? false : void 0,
+			file: raw.File ? this.parseFileDetails(raw.File) : void 0
+		};
+	}
+	parseImages(resourceList) {
+		if (!resourceList) return void 0;
+		const images = ensureArray(resourceList.Image);
+		if (images.length === 0) return void 0;
+		return images.map((img) => this.parseImage(img));
+	}
+	parseImage(raw) {
+		return {
+			resourceReference: raw.ResourceReference,
+			type: raw.ImageType ?? void 0,
+			imageId: raw.ImageId ? this.parseImageId(raw.ImageId) : void 0,
+			detailsByTerritory: raw.ImageDetailsByTerritory ? ensureArray(raw.ImageDetailsByTerritory).map((d) => this.parseImageDetailsByTerritory(d)) : void 0
+		};
+	}
+	parseImageId(raw) {
+		const propId = raw.ProprietaryId;
+		if (!propId) return void 0;
+		return {
+			proprietaryId: typeof propId === "string" ? propId : propId["#text"] ?? "",
+			proprietaryIdNamespace: typeof propId === "object" ? propId["@_Namespace"] ?? void 0 : void 0
+		};
+	}
+	parseImageDetailsByTerritory(raw) {
+		return {
+			territoryCode: ensureArray(raw.TerritoryCode),
+			parentalWarningType: raw.ParentalWarningType ?? void 0,
+			technicalDetails: raw.TechnicalImageDetails ? this.parseTechnicalImageDetails(Array.isArray(raw.TechnicalImageDetails) ? raw.TechnicalImageDetails[0] : raw.TechnicalImageDetails) : void 0
+		};
+	}
+	parseTechnicalImageDetails(raw) {
+		return {
+			technicalResourceDetailsReference: raw.TechnicalResourceDetailsReference ?? void 0,
+			imageCodecType: raw.ImageCodecType ?? void 0,
+			imageHeight: raw.ImageHeight ? Number(raw.ImageHeight) : void 0,
+			imageWidth: raw.ImageWidth ? Number(raw.ImageWidth) : void 0,
+			file: raw.File ? this.parseFileDetails(raw.File) : void 0
+		};
+	}
+	parseFileDetails(raw) {
+		return {
+			fileName: raw.FileName ?? void 0,
+			uri: raw.URI ?? void 0,
+			hashSum: raw.HashSum ? this.parseHashSum(raw.HashSum) : void 0
+		};
+	}
+	parseHashSum(raw) {
+		return {
+			algorithm: raw.HashSumAlgorithmType ?? raw.Algorithm ?? void 0,
+			hashSumValue: raw.HashSum ?? raw.HashSumValue ?? void 0
 		};
 	}
 	parseReleases(releaseList) {
@@ -247,10 +317,19 @@ var Ern38Converter = class {
 			icpn: typeof icpnRaw === "string" ? icpnRaw : icpnRaw["#text"],
 			isEan: typeof icpnRaw === "object" && icpnRaw["@_IsEan"] === "true" ? true : void 0
 		};
+		const catalogNumberRaw = raw.CatalogNumber;
+		let catalogNumber;
+		let catalogNumberNamespace;
+		if (catalogNumberRaw) if (typeof catalogNumberRaw === "string") catalogNumber = catalogNumberRaw;
+		else {
+			catalogNumber = catalogNumberRaw["#text"] ?? void 0;
+			catalogNumberNamespace = catalogNumberRaw["@_Namespace"] ?? void 0;
+		}
 		return {
 			isrc: raw.ISRC ?? void 0,
 			gridOrIcpn: raw.GRid ?? void 0,
-			catalogNumber: raw.CatalogNumber ?? void 0
+			catalogNumber,
+			catalogNumberNamespace
 		};
 	}
 	parseReleaseResourceReferences(raw) {
@@ -351,11 +430,21 @@ var Ern38Converter = class {
 		return artists.map((a) => ({
 			artist: {
 				name: a.PartyName?.FullName ?? "",
-				roles: a.ArtistRole ? ensureArray(a.ArtistRole) : void 0
+				roles: a.ArtistRole ? this.parseArtistRoles(a.ArtistRole) : void 0
 			},
 			sequenceNumber: a["@_SequenceNumber"] ? Number(a["@_SequenceNumber"]) : void 0
 		}));
 	}
+	parseArtistRoles(raw) {
+		return ensureArray(raw).map((r) => {
+			if (typeof r === "string") return { role: r };
+			return {
+				role: r["#text"] ?? "",
+				namespace: r["@_Namespace"] ?? void 0,
+				userDefinedValue: r["@_UserDefinedValue"] ?? void 0
+			};
+		});
+	}
 	parseResourceContributors(raw) {
 		if (!raw) return void 0;
 		const contributors = ensureArray(raw);
@@ -376,6 +465,7 @@ var Ern38Converter = class {
 				name: c.PartyName?.FullName ?? "",
 				role,
 				sequenceNumber: c["@_SequenceNumber"] ? Number(c["@_SequenceNumber"]) : void 0,
+				instrumentType: c.InstrumentType ?? void 0,
 				roleNamespace,
 				roleUserDefinedValue
 			};
@@ -431,7 +521,9 @@ var Ern4Converter = class {
 		return {
 			ernVersion: version,
 			messageHeader: this.parseMessageHeader(root.MessageHeader),
+			updateIndicator: root["@_UpdateIndicator"] ?? void 0,
 			resourceList: this.parseSoundRecordings(root.ResourceList),
+			imageList: this.parseImages(root.ResourceList),
 			releaseList: this.parseReleases(root.ReleaseList),
 			dealList: this.parseDealList(root.DealList),
 			partyList,
@@ -472,10 +564,13 @@ var Ern4Converter = class {
 			partyId: partyIds.length > 0 ? partyIds : void 0
 		};
 	}
-	resolveArtistName(partyReference) {
+	resolveParty(partyReference) {
 		const party = this.partyIndex.get(partyReference);
-		if (!party?.partyName?.length) return partyReference;
-		return party.partyName[0].fullName;
+		if (!party?.partyName?.length) return { name: partyReference };
+		return {
+			name: party.partyName[0].fullName,
+			names: party.partyName.length > 1 ? party.partyName : void 0
+		};
 	}
 	parseMessageHeader(raw) {
 		return {
@@ -538,6 +633,43 @@ var Ern4Converter = class {
 			catalogNumber: raw.CatalogNumber ?? void 0
 		};
 	}
+	parseImages(resourceList) {
+		if (!resourceList) return void 0;
+		const images = ensureArray(resourceList.Image);
+		if (images.length === 0) return void 0;
+		return images.map((img) => {
+			const result = {
+				resourceReference: img.ResourceReference,
+				type: img.Type ?? void 0,
+				parentalWarningType: img.ParentalWarningType ?? void 0
+			};
+			if (img.ResourceId) {
+				const propId = img.ResourceId.ProprietaryId;
+				if (propId) result.imageId = {
+					proprietaryId: typeof propId === "string" ? propId : propId["#text"] ?? "",
+					proprietaryIdNamespace: typeof propId === "object" ? propId["@_Namespace"] ?? void 0 : void 0
+				};
+			}
+			if (img.TechnicalDetails) {
+				const td = Array.isArray(img.TechnicalDetails) ? img.TechnicalDetails[0] : img.TechnicalDetails;
+				result.technicalDetails = {
+					technicalResourceDetailsReference: td.TechnicalResourceDetailsReference ?? void 0,
+					imageCodecType: td.ImageCodecType ?? void 0,
+					imageHeight: td.ImageHeight ? Number(td.ImageHeight) : void 0,
+					imageWidth: td.ImageWidth ? Number(td.ImageWidth) : void 0,
+					file: td.File ? {
+						uri: td.File.URI ?? void 0,
+						fileName: td.File.FileName ?? void 0,
+						hashSum: td.File.HashSum ? {
+							algorithm: td.File.HashSum.Algorithm ?? void 0,
+							hashSumValue: td.File.HashSum.HashSumValue ?? void 0
+						} : void 0
+					} : void 0
+				};
+			}
+			return result;
+		});
+	}
 	parseReleases(releaseList) {
 		if (!releaseList) return [];
 		return ensureArray(releaseList.Release).map((r) => this.parseRelease(r));
@@ -574,10 +706,19 @@ var Ern4Converter = class {
 		const propId = raw.ProprietaryId;
 		let proprietaryId;
 		if (propId) proprietaryId = typeof propId === "string" ? propId : propId["#text"];
+		const catalogNumberRaw = raw.CatalogNumber;
+		let catalogNumber;
+		let catalogNumberNamespace;
+		if (catalogNumberRaw) if (typeof catalogNumberRaw === "string") catalogNumber = catalogNumberRaw;
+		else {
+			catalogNumber = catalogNumberRaw["#text"] ?? void 0;
+			catalogNumberNamespace = catalogNumberRaw["@_Namespace"] ?? void 0;
+		}
 		return {
 			isrc: raw.ISRC ?? void 0,
 			gridOrIcpn: raw.GRid ?? void 0,
-			catalogNumber: raw.CatalogNumber ?? void 0,
+			catalogNumber,
+			catalogNumberNamespace,
 			proprietaryId
 		};
 	}
@@ -675,23 +816,38 @@ var Ern4Converter = class {
 		if (artists.length === 0) return void 0;
 		return artists.map((a) => {
 			const partyRef = a.ArtistPartyReference;
+			const resolved = partyRef ? this.resolveParty(partyRef) : {
+				name: a.PartyName?.FullName ?? "",
+				names: void 0
+			};
 			return {
 				artist: {
-					name: partyRef ? this.resolveArtistName(partyRef) : a.PartyName?.FullName ?? "",
+					name: resolved.name,
+					names: resolved.names,
 					partyReference: partyRef ?? void 0,
-					roles: a.DisplayArtistRole ? ensureArray(a.DisplayArtistRole) : void 0
+					roles: a.DisplayArtistRole ? this.parseArtistRoles(a.DisplayArtistRole) : void 0
 				},
 				sequenceNumber: a["@_SequenceNumber"] ? Number(a["@_SequenceNumber"]) : void 0
 			};
 		});
 	}
+	parseArtistRoles(raw) {
+		return ensureArray(raw).map((r) => {
+			if (typeof r === "string") return { role: r };
+			return {
+				role: r["#text"] ?? "",
+				namespace: r["@_Namespace"] ?? void 0,
+				userDefinedValue: r["@_UserDefinedValue"] ?? void 0
+			};
+		});
+	}
 	parseContributors(raw) {
 		if (!raw) return void 0;
 		const contributors = ensureArray(raw);
 		if (contributors.length === 0) return void 0;
 		return contributors.map((c) => {
 			const partyRef = c.ContributorPartyReference;
-			const name = partyRef ? this.resolveArtistName(partyRef) : void 0;
+			const name = partyRef ? this.resolveParty(partyRef).name : void 0;
 			return {
 				contributorPartyReference: partyRef ?? "",
 				name,
@@ -739,6 +895,7 @@ var Ern4Converter = class {
 //#region src/converter/json-to-xml/ern38-builder.ts
 var Ern38Builder = class {
 	build(message, version) {
+		const msg = message;
 		const nsUri = VERSION_NAMESPACE_MAP.get(version);
 		if (!nsUri) throw new Error(`Unknown version: ${version}`);
 		const nsPath = new URL(nsUri).pathname.replace(/^\/xml\//, "");
@@ -747,11 +904,11 @@ var Ern38Builder = class {
 			"@_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
 			"@_MessageSchemaVersionId": nsPath,
 			"@_xsi:schemaLocation": `${nsUri} ${nsUri}/release-notification.xsd`,
-			MessageHeader: this.buildMessageHeader(message.messageHeader),
-			...message.updateIndicator ? { UpdateIndicator: message.updateIndicator } : {},
-			ResourceList: this.buildResourceList(message.resourceList),
-			ReleaseList: this.buildReleaseList(message.releaseList),
-			DealList: this.buildDealList(message.dealList)
+			MessageHeader: this.buildMessageHeader(msg.messageHeader),
+			...msg.updateIndicator ? { UpdateIndicator: msg.updateIndicator } : {},
+			ResourceList: this.buildResourceList(msg.resourceList, msg.imageList),
+			ReleaseList: this.buildReleaseList(msg.releaseList),
+			DealList: this.buildDealList(msg.dealList)
 		} };
 		return `<?xml version="1.0" encoding="UTF-8"?>\n${new XMLBuilder(BUILDER_OPTIONS).build(root)}`.trimEnd();
 	}
@@ -775,8 +932,10 @@ var Ern38Builder = class {
 		if (party.tradingName) result.TradingName = party.tradingName;
 		return result;
 	}
-	buildResourceList(soundRecordings) {
-		return { SoundRecording: soundRecordings.map((sr) => this.buildSoundRecording(sr)) };
+	buildResourceList(soundRecordings, images) {
+		const result = { SoundRecording: soundRecordings.map((sr) => this.buildSoundRecording(sr)) };
+		if (images?.length) result.Image = images.map((img) => this.buildImage(img));
+		return result;
 	}
 	buildSoundRecording(sr) {
 		const result = {};
@@ -804,6 +963,7 @@ var Ern38Builder = class {
 		result.TerritoryCode = d.territoryCode;
 		if (d.titles) result.Title = d.titles.map((t) => this.buildTitle(t));
 		if (d.displayArtists) result.DisplayArtist = d.displayArtists.map((a) => this.buildDisplayArtist(a));
+		if (d.displayArtistName) result.DisplayArtistName = d.displayArtistName;
 		if (d.resourceContributors) result.ResourceContributor = d.resourceContributors.map((c) => this.buildResourceContributor(c));
 		if (d.indirectResourceContributors) result.IndirectResourceContributor = d.indirectResourceContributors.map((c) => this.buildIndirectResourceContributor(c));
 		if (d.labelName) result.LabelName = d.labelName;
@@ -811,6 +971,75 @@ var Ern38Builder = class {
 		if (d.sequenceNumber != null) result.SequenceNumber = String(d.sequenceNumber);
 		if (d.genre) result.Genre = this.buildGenre(d.genre);
 		if (d.parentalWarningType) result.ParentalWarningType = d.parentalWarningType;
+		if (d.technicalDetails) result.TechnicalSoundRecordingDetails = d.technicalDetails.map((td) => this.buildTechnicalSoundRecordingDetails(td));
+		return result;
+	}
+	buildTechnicalSoundRecordingDetails(td) {
+		const result = {};
+		if (td.technicalResourceDetailsReference) result.TechnicalResourceDetailsReference = td.technicalResourceDetailsReference;
+		if (td.audioCodecType) result.AudioCodecType = td.audioCodecType;
+		if (td.bitRate != null) result.BitRate = td.bitRateUnit ? {
+			"#text": String(td.bitRate),
+			"@_UnitOfMeasure": td.bitRateUnit
+		} : String(td.bitRate);
+		if (td.bitsPerSample != null) result.BitsPerSample = String(td.bitsPerSample);
+		if (td.numberOfChannels != null) result.NumberOfChannels = String(td.numberOfChannels);
+		if (td.samplingRate != null) result.SamplingRate = td.samplingRateUnit ? {
+			"#text": String(td.samplingRate),
+			"@_UnitOfMeasure": td.samplingRateUnit
+		} : String(td.samplingRate);
+		if (td.isPreview != null) result.IsPreview = String(td.isPreview);
+		if (td.file) {
+			const file = {};
+			if (td.file.fileName) file.FileName = td.file.fileName;
+			if (td.file.uri) file.URI = td.file.uri;
+			if (td.file.hashSum) {
+				file.HashSum = {};
+				if (td.file.hashSum.algorithm) file.HashSum.HashSumAlgorithmType = td.file.hashSum.algorithm;
+				if (td.file.hashSum.hashSumValue) file.HashSum.HashSum = td.file.hashSum.hashSumValue;
+			}
+			result.File = file;
+		}
+		return result;
+	}
+	buildImage(img) {
+		const result = {};
+		if (img.type) result.ImageType = img.type;
+		if (img.imageId) {
+			const id = {};
+			if (img.imageId.proprietaryId) id.ProprietaryId = img.imageId.proprietaryIdNamespace ? {
+				"#text": img.imageId.proprietaryId,
+				"@_Namespace": img.imageId.proprietaryIdNamespace
+			} : img.imageId.proprietaryId;
+			result.ImageId = id;
+		}
+		result.ResourceReference = img.resourceReference;
+		if (img.detailsByTerritory) result.ImageDetailsByTerritory = img.detailsByTerritory.map((d) => {
+			const dbt = {};
+			dbt.TerritoryCode = d.territoryCode;
+			if (d.parentalWarningType) dbt.ParentalWarningType = d.parentalWarningType;
+			if (d.technicalDetails) dbt.TechnicalImageDetails = this.buildTechnicalImageDetails(d.technicalDetails);
+			return dbt;
+		});
+		return result;
+	}
+	buildTechnicalImageDetails(td) {
+		const result = {};
+		if (td.technicalResourceDetailsReference) result.TechnicalResourceDetailsReference = td.technicalResourceDetailsReference;
+		if (td.imageCodecType) result.ImageCodecType = td.imageCodecType;
+		if (td.imageHeight != null) result.ImageHeight = String(td.imageHeight);
+		if (td.imageWidth != null) result.ImageWidth = String(td.imageWidth);
+		if (td.file) {
+			const file = {};
+			if (td.file.fileName) file.FileName = td.file.fileName;
+			if (td.file.uri) file.URI = td.file.uri;
+			if (td.file.hashSum) {
+				file.HashSum = {};
+				if (td.file.hashSum.algorithm) file.HashSum.HashSumAlgorithmType = td.file.hashSum.algorithm;
+				if (td.file.hashSum.hashSumValue) file.HashSum.HashSum = td.file.hashSum.hashSumValue;
+			}
+			result.File = file;
+		}
 		return result;
 	}
 	buildReleaseList(releases) {
@@ -838,7 +1067,10 @@ var Ern38Builder = class {
 		const result = {};
 		if (id.isrc) result.ISRC = id.isrc;
 		if (id.gridOrIcpn) result.GRid = id.gridOrIcpn;
-		if (id.catalogNumber) result.CatalogNumber = id.catalogNumber;
+		if (id.catalogNumber) result.CatalogNumber = id.catalogNumberNamespace ? {
+			"#text": id.catalogNumber,
+			"@_Namespace": id.catalogNumberNamespace
+		} : id.catalogNumber;
 		return result;
 	}
 	buildReleaseResourceReference(ref) {
@@ -909,9 +1141,20 @@ var Ern38Builder = class {
 		const result = {};
 		if (da.sequenceNumber != null) result["@_SequenceNumber"] = String(da.sequenceNumber);
 		result.PartyName = { FullName: da.artist.name };
-		if (da.artist.roles?.length) result.ArtistRole = da.artist.roles.length === 1 ? da.artist.roles[0] : da.artist.roles;
+		if (da.artist.roles?.length) {
+			const builtRoles = da.artist.roles.map((r) => this.buildArtistRole(r));
+			result.ArtistRole = builtRoles.length === 1 ? builtRoles[0] : builtRoles;
+		}
 		return result;
 	}
+	buildArtistRole(r) {
+		if (r.userDefinedValue) return {
+			"#text": r.role,
+			...r.namespace ? { "@_Namespace": r.namespace } : {},
+			"@_UserDefinedValue": r.userDefinedValue
+		};
+		return r.role;
+	}
 	buildResourceContributor(c) {
 		const result = {};
 		if (c.sequenceNumber != null) result["@_SequenceNumber"] = String(c.sequenceNumber);
@@ -922,6 +1165,7 @@ var Ern38Builder = class {
 			"@_UserDefinedValue": c.roleUserDefinedValue
 		};
 		else result.ResourceContributorRole = c.role;
+		if (c.instrumentType) result.InstrumentType = c.instrumentType;
 		return result;
 	}
 	buildIndirectResourceContributor(c) {
@@ -961,6 +1205,7 @@ var Ern38Builder = class {
 //#region src/converter/json-to-xml/ern4-builder.ts
 var Ern4Builder = class {
 	build(message, version) {
+		const msg = message;
 		const nsUri = VERSION_NAMESPACE_MAP.get(version);
 		if (!nsUri) throw new Error(`Unknown version: ${version}`);
 		const root = { "ern:NewReleaseMessage": {
@@ -968,11 +1213,12 @@ var Ern4Builder = class {
 			"@_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
 			"@_xsi:schemaLocation": `${nsUri} ${nsUri}/release-notification.xsd`,
 			"@_LanguageAndScriptCode": "en",
-			MessageHeader: this.buildMessageHeader(message.messageHeader),
-			PartyList: this.buildPartyList(message.partyList ?? []),
-			ResourceList: this.buildResourceList(message.resourceList, version),
-			ReleaseList: this.buildReleaseList(message.releaseList, message.trackReleaseList),
-			DealList: this.buildDealList(message.dealList)
+			...msg.updateIndicator ? { "@_UpdateIndicator": msg.updateIndicator } : {},
+			MessageHeader: this.buildMessageHeader(msg.messageHeader),
+			PartyList: this.buildPartyList(msg.partyList ?? []),
+			ResourceList: this.buildResourceList(msg.resourceList, msg.imageList, version),
+			ReleaseList: this.buildReleaseList(msg.releaseList, msg.trackReleaseList),
+			DealList: this.buildDealList(msg.dealList)
 		} };
 		return `<?xml version="1.0" encoding="UTF-8"?>\n${new XMLBuilder(BUILDER_OPTIONS).build(root)}`.trimEnd();
 	}
@@ -1009,8 +1255,40 @@ var Ern4Builder = class {
 		if (party.partyId?.length) result.PartyId = party.partyId.map((id) => id);
 		return result;
 	}
-	buildResourceList(soundRecordings, _version) {
-		return { SoundRecording: soundRecordings.map((sr) => this.buildSoundRecording(sr)) };
+	buildResourceList(soundRecordings, images, _version) {
+		const result = { SoundRecording: soundRecordings.map((sr) => this.buildSoundRecording(sr)) };
+		if (images?.length) result.Image = images.map((img) => this.buildImage(img));
+		return result;
+	}
+	buildImage(img) {
+		const result = {};
+		result.ResourceReference = img.resourceReference;
+		if (img.type) result.Type = img.type;
+		if (img.imageId?.proprietaryId) result.ResourceId = { ProprietaryId: img.imageId.proprietaryIdNamespace ? {
+			"#text": img.imageId.proprietaryId,
+			"@_Namespace": img.imageId.proprietaryIdNamespace
+		} : img.imageId.proprietaryId };
+		if (img.parentalWarningType) result.ParentalWarningType = img.parentalWarningType;
+		if (img.technicalDetails) {
+			const td = {};
+			if (img.technicalDetails.technicalResourceDetailsReference) td.TechnicalResourceDetailsReference = img.technicalDetails.technicalResourceDetailsReference;
+			if (img.technicalDetails.imageCodecType) td.ImageCodecType = img.technicalDetails.imageCodecType;
+			if (img.technicalDetails.imageHeight != null) td.ImageHeight = String(img.technicalDetails.imageHeight);
+			if (img.technicalDetails.imageWidth != null) td.ImageWidth = String(img.technicalDetails.imageWidth);
+			if (img.technicalDetails.file) {
+				const file = {};
+				if (img.technicalDetails.file.uri) file.URI = img.technicalDetails.file.uri;
+				if (img.technicalDetails.file.fileName) file.FileName = img.technicalDetails.file.fileName;
+				if (img.technicalDetails.file.hashSum) {
+					file.HashSum = {};
+					if (img.technicalDetails.file.hashSum.algorithm) file.HashSum.Algorithm = img.technicalDetails.file.hashSum.algorithm;
+					if (img.technicalDetails.file.hashSum.hashSumValue) file.HashSum.HashSumValue = img.technicalDetails.file.hashSum.hashSumValue;
+				}
+				td.File = file;
+			}
+			result.TechnicalDetails = td;
+		}
+		return result;
 	}
 	buildSoundRecording(sr) {
 		const result = {};
@@ -1063,7 +1341,10 @@ var Ern4Builder = class {
 		if (id.isrc) result.ISRC = id.isrc;
 		if (id.gridOrIcpn) result.GRid = id.gridOrIcpn;
 		if (id.proprietaryId) result.ProprietaryId = id.proprietaryId;
-		if (id.catalogNumber) result.CatalogNumber = id.catalogNumber;
+		if (id.catalogNumber) result.CatalogNumber = id.catalogNumberNamespace ? {
+			"#text": id.catalogNumber,
+			"@_Namespace": id.catalogNumberNamespace
+		} : id.catalogNumber;
 		return result;
 	}
 	buildTrackRelease(tr) {
@@ -1131,9 +1412,20 @@ var Ern4Builder = class {
 		const result = {};
 		if (da.sequenceNumber != null) result["@_SequenceNumber"] = String(da.sequenceNumber);
 		if (da.artist.partyReference) result.ArtistPartyReference = da.artist.partyReference;
-		if (da.artist.roles?.length) result.DisplayArtistRole = da.artist.roles.length === 1 ? da.artist.roles[0] : da.artist.roles;
+		if (da.artist.roles?.length) {
+			const builtRoles = da.artist.roles.map((r) => this.buildArtistRole(r));
+			result.DisplayArtistRole = builtRoles.length === 1 ? builtRoles[0] : builtRoles;
+		}
 		return result;
 	}
+	buildArtistRole(r) {
+		if (r.userDefinedValue) return {
+			"#text": r.role,
+			...r.namespace ? { "@_Namespace": r.namespace } : {},
+			"@_UserDefinedValue": r.userDefinedValue
+		};
+		return r.role;
+	}
 	buildContributor(c) {
 		const result = {};
 		if (c.sequenceNumber != null) result["@_SequenceNumber"] = String(c.sequenceNumber);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ddex-json-codec",
   "type": "module",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "DDEX ERN XML ↔ JSON converter for TypeScript",
   "license": "MIT",
   "author": "kazhs",