playlist-data-engine 1.5.8 → 1.6.0

package/dist/essentia.js-model.es-h47asA0k.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var m=function(a,t){return m=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(e,r){e.__proto__=r}||function(e,r){for(var s in r)r.hasOwnProperty(s)&&(e[s]=r[s])},m(a,t)};function p(a,t){m(a,t);function e(){this.constructor=a}a.prototype=t===null?Object.create(t):(e.prototype=t.prototype,new e)}function c(a,t,e,r){return new(e||(e=Promise))(function(s,n){function o(i){try{u(r.next(i))}catch(f){n(f)}}function l(i){try{u(r.throw(i))}catch(f){n(f)}}function u(i){i.done?s(i.value):new e(function(f){f(i.value)}).then(o,l)}u((r=r.apply(a,[])).next())})}function h(a,t){var e={label:0,sent:function(){if(n[0]&1)throw n[1];return n[1]},trys:[],ops:[]},r,s,n,o;return o={next:l(0),throw:l(1),return:l(2)},typeof Symbol=="function"&&(o[Symbol.iterator]=function(){return this}),o;function l(i){return function(f){return u([i,f])}}function u(i){if(r)throw new TypeError("Generator is already executing.");for(;e;)try{if(r=1,s&&(n=i[0]&2?s.return:i[0]?s.throw||((n=s.return)&&n.call(s),0):s.next)&&!(n=n.call(s,i[1])).done)return n;switch(s=0,n&&(i=[i[0]&2,n.value]),i[0]){case 0:case 1:n=i;break;case 4:return e.label++,{value:i[1],done:!1};case 5:e.label++,s=i[1],i=[0];continue;case 7:i=e.ops.pop(),e.trys.pop();continue;default:if(n=e.trys,!(n=n.length>0&&n[n.length-1])&&(i[0]===6||i[0]===2)){e=0;continue}if(i[0]===3&&(!n||i[1]>n[0]&&i[1]<n[3])){e.label=i[1];break}if(i[0]===6&&e.label<n[1]){e.label=n[1],n=i;break}if(n&&e.label<n[2]){e.label=n[2],e.ops.push(i);break}n[2]&&e.ops.pop(),e.trys.pop();continue}i=t.call(a,e)}catch(f){i=[6,f],s=0}finally{r=n=0}if(i[0]&5)throw i[1];return{value:i[0]?i[1]:void 0,done:!0}}}var y=(function(){function a(t,e,r){if(e===void 0&&(e="musicnn"),r===void 0&&(r=!1),this.essentia=null,this.module=null,this.frameSize=512,this.sampleRate=16e3,this.extractorType=e,this.extractorType==="musicnn")this.frameSize=512;else if(this.extractorType==="vggish")this.frameSize=400;else if(this.extractorType==="tempocnn")this.frameSize=1024;else throw Error("Invalid 'extractorType' choice! Available types are [musicnn', 'vggish', 'tempocnn']");this.essentia=new t.EssentiaJS(r),this.module=t}return a.prototype.arrayToVector=function(t){return this.module.arrayToVector(t)},a.prototype.vectorToArray=function(t){return this.module.vectorToArray(t)},a.prototype.getAudioBufferFromURL=function(t,e){return c(this,void 0,void 0,function(){var r,s,n;return h(this,function(o){switch(o.label){case 0:return[4,fetch(t)];case 1:return r=o.sent(),[4,r.arrayBuffer()];case 2:return s=o.sent(),[4,e.decodeAudioData(s)];case 3:return n=o.sent(),[2,n]}})})},a.prototype.audioBufferToMonoSignal=function(t){if(t.numberOfChannels===1)return t.getChannelData(0);if(t.numberOfChannels===2){var e=this.arrayToVector(t.getChannelData(0)),r=this.arrayToVector(t.getChannelData(1)),s=this.essentia.MonoMixer(e,r).audio;return this.vectorToArray(s)}throw new Error("Unexpected number of channels found in audio buffer. Only accepts mono or stereo audio buffers.")},a.prototype.downsampleAudioBuffer=function(t){var e=new OfflineAudioContext(1,t.duration*this.sampleRate,this.sampleRate),r=e.createBuffer(1,t.length,t.sampleRate);r.copyToChannel(this.audioBufferToMonoSignal(t),0);var s=e.createBufferSource();return s.buffer=r,s.connect(e.destination),new Promise(function(n){e.oncomplete=function(o){var l=o.renderedBuffer,u=l.getChannelData(0);n(u)},e.startRendering(),s.start(0)})},a.prototype.compute=function(t){var e;switch(t instanceof Float32Array?e=this.arrayToVector(t):e=t,this.extractorType){case"musicnn":{if(t.length!=this.frameSize)throw new Error("The chosen `extractorType` only works with an audio signal frame size of "+this.frameSize);var r=this.essentia.TensorflowInputMusiCNN(e);return{melSpectrum:this.vectorToArray(r.bands),frameSize:1,patchSize:187,melBandsSize:96}}case"vggish":{if(t.length!=this.frameSize)throw new Error("The chosen `extractorType` only works with an audio signal frame size of 400 "+this.frameSize);var r=this.essentia.TensorflowInputVGGish(e);return{melSpectrum:this.vectorToArray(r.bands),frameSize:1,patchSize:96,melBandsSize:64}}case"tempocnn":{if(t.length!=this.frameSize)throw Error("The chosen `extractorType` only works with an audio signal frame size of "+this.frameSize);var r=this.essentia.TensorflowInputTempoCNN(e);return{melSpectrum:this.vectorToArray(r.bands),frameSize:1,patchSize:256,melBandsSize:40}}default:throw Error("Invalid 'extractorType' choice! Available types are [musicnn', 'vggish', 'tempocnn']")}},a.prototype.computeFrameWise=function(t,e){var r;e?r=e:r=this.frameSize;for(var s=this.essentia.FrameGenerator(t,this.frameSize,r),n=[],o=null,l=0;l<s.size();l++)o=this.compute(this.vectorToArray(s.get(l))),n.push(o.melSpectrum);return o.melSpectrum=n,o.frameSize=s.size(),s.delete(),o},a.prototype.delete=function(){this.essentia.delete()},a.prototype.shutdown=function(){this.essentia.shutdown()},a})();var d=(function(){function a(t,e,r){this.model=null,this.audioSampleRate=16e3,this.tf=null,this.isReady=!1,this.modelPath="",this.IS_TRAIN=null,this.randomTensorInput=null,this.minimumInputFrameSize=null,this.tf=t,this.IS_TRAIN=this.tf.tensor([0],[1],"bool"),this.modelPath=e,this.isReady=!!this.model}return a.prototype.initialize=function(){return c(this,void 0,void 0,function(){var t;return h(this,function(e){switch(e.label){case 0:return t=this,[4,this.tf.loadGraphModel(this.modelPath)];case 1:return t.model=e.sent(),this.isReady=!0,[2]}})})},a.prototype.arrayToTensorAsBatches=function(t,e,r,s){s===void 0&&(s=!1);var n=this.tf.tensor(t,e,"float32"),o,l;return s?e[0]===r?n.as3D(1,r,e[1]):e[0]>r?e[0]%r!=0?(l=Math.floor(e[0]/r)+1,o=this.tf.zeros([Math.floor(l*r-t.length),e[1]],"float32"),n=n.concat(o),o.dispose(),n.as3D(l,r,e[1])):(l=Math.floor(e[0]/r),o=this.tf.zeros([Math.floor(l*r-t.length),e[1]],"float32"),n=n.concat(o),o.dispose(),n.as3D(l,r,e[1])):(l=1,o=this.tf.zeros([r-e[0],e[1]]),n=n.concat(o),o.dispose(),n.as3D(l,r,e[1])):(this.assertMinimumFeatureInputSize({melSpectrum:t,frameSize:e[0],melBandsSize:e[1],patchSize:r}),n.as3D(1,r,e[1]))},a.prototype.dispose=function(){this.model.dispose()},a.prototype.assertMinimumFeatureInputSize=function(t){if(this.minimumInputFrameSize=t.patchSize,t.melSpectrum.length!=this.minimumInputFrameSize)throw Error("When `padding=false` in `predict` method, the model expect audio feature for a minimum frame size of "+this.minimumInputFrameSize+". Was given "+t.melSpectrum.length+" melband frames")},a.prototype.disambiguateExtraInputs=function(){if(!this.isReady)throw Error("No loaded tfjs model found! Make sure to call `initialize` method and resolve the promise before calling `predict` method.");var t=this.model.executor.inputs.length;if(t===1)return[];if(t===2)return[this.IS_TRAIN.clone()];if(t===3)return this.randomTensorInput||(this.randomTensorInput=this.tf.zeros([1,this.model.executor.inputs[0].shape[1]])),[this.randomTensorInput.clone(),this.IS_TRAIN.clone()];throw Error("Found unsupported number of input requirements for the model. Expects the following inputs -> "+this.model.executor.inputs)},a})(),v=(function(a){p(t,a);function t(e,r,s){var n=a.call(this,e,r)||this;return n.minimumInputFrameSize=3,n}return t.prototype.predict=function(e,r){return r===void 0&&(r=!1),c(this,void 0,void 0,function(){var s,n,o,l;return h(this,function(u){switch(u.label){case 0:return s=this.arrayToTensorAsBatches(e.melSpectrum,[e.frameSize,e.melBandsSize],e.patchSize,r),n=this.disambiguateExtraInputs(),n.push(s),o=this.model.execute(n),s.dispose(),[4,o.array()];case 1:return l=u.sent(),o.dispose(),[2,l]}})})},t})(d),T=(function(a){p(t,a);function t(e,r,s){return a.call(this,e,r)||this}return t.prototype.predict=function(e,r){return r===void 0&&(r=!1),c(this,void 0,void 0,function(){var s,n,o,l;return h(this,function(u){switch(u.label){case 0:return s=this.arrayToTensorAsBatches(e.melSpectrum,[e.frameSize,e.melBandsSize],e.patchSize,r),n=this.disambiguateExtraInputs(),n.push(s),o=this.model.execute(n),s.dispose(),[4,o.array()];case 1:return l=u.sent(),o.dispose(),[2,l]}})})},t})(d);exports.EssentiaTFInputExtractor=y;exports.EssentiaTensorflowJSModel=d;exports.TensorflowMusiCNN=v;exports.TensorflowVGGish=T;

package/dist/gateway.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file TF-free gateway entry point.
+ *
+ * Re-exports only the Arweave gateway manager, Arweave/IPFS URL utilities, and
+ * their types. Deliberately does NOT re-export anything from `core/analysis/`
+ * (MusicClassifier, EssentiaPitchDetector) or `utils/modelCache.ts`, so that
+ * consumers importing from `playlist-data-engine/gateway` do not pull
+ * `@tensorflow/tfjs` into their bundle.
+ *
+ * The full library (including TF-dependent audio analysis) remains available
+ * from the main entry: `playlist-data-engine`.
+ */
+export { type GatewayConfig, type ArweaveUrlInfo, DEFAULT_GATEWAYS, KNOWN_GATEWAY_HOSTS, isArweaveUrl, parseArweaveUrl, constructGatewayUrl, getAllGatewayUrls, } from './utils/arweaveUtils.js';
+export { ArweaveGatewayManager, arweaveGatewayManager, type GatewayCache, type GatewayCheckResult, type ResolveUrlOptions, type ArweaveGatewayManagerConfig, type PrefetchOptions, type PrefetchResultEntry, type PrefetchResult, type CacheStats, type GatewayHealthStats, type HealthCheckResult, type HealthCheckOptions, type GatewayDiagnostics, } from './utils/arweaveGatewayManager.js';
+export { KNOWN_IPFS_GATEWAY_HOSTS, DEFAULT_IPFS_GATEWAY, extractIPFSPath, isIPFS, resolveIPFSLink, type ResolveIPFSOptions, } from './utils/ipfsUtils.js';
+export { MetadataExtractor } from './core/parser/MetadataExtractor.js';
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GAC1B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACH,wBAAwB,EACxB,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,eAAe,EACf,KAAK,kBAAkB,GAC1B,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/gateway.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./arweaveGatewayManager-CeW9SP2P.cjs");class l{static extractAudioUrl(t){const e=["mp3_url","mp3Url","lossy_audio","lossyAudio","animation_url","animationUrl","audio_url","audioUrl","lossless_audio","losslessAudio","audio","multimedia_url","multimediaUrl"];for(const r of e)if(t[r]&&typeof t[r]=="string")return t[r];return null}static extractAudioUrlLossless(t){const e=["lossless_audio","losslessAudio","wav_url","wavUrl","flac_url","flacUrl","audio_url","audioUrl"];for(const r of e)if(t[r]&&typeof t[r]=="string")return t[r];return null}static extractImageUrl(t){const e=["image_small","imageSmall","image","image_large","imageLarge","image_thumb","imageThumb","image_url","imageUrl","image_uri","imageUri","image_preview","imagePreview"];for(const i of e)if(t[i]&&typeof t[i]=="string")return t[i];const r=[this.extractNestedUri(t,"artwork","uri"),this.extractNestedUri(t,"project","artwork","uri"),this.extractNestedUri(t,"primaryMedia","uri")];for(const i of r)if(i)return i;return null}static extractImageThumbUrl(t){return t.image_thumb_url&&typeof t.image_thumb_url=="string"?t.image_thumb_url:t.image_thumb&&typeof t.image_thumb=="string"?t.image_thumb:null}static extractTitle(t){return t.name&&typeof t.name=="string"?t.name:t.title&&typeof t.title=="string"?t.title:null}static extractArtist(t){const e=["artist","artist_name","artistName","album_artist","albumArtist","created_by","createdBy","minter"];for(const r of e)if(t[r]&&typeof t[r]=="string")return t[r];if(Array.isArray(t.attributes)){const r=t.attributes.find(i=>i.trait_type?.toLowerCase()==="artist"&&i.value!==void 0);if(r&&typeof r.value=="string")return r.value}return null}static parseMetadata(t){if(!t)return null;if(typeof t=="object"&&!Array.isArray(t))return t;if(typeof t=="string")try{const e=JSON.parse(t);if(typeof e=="object"&&!Array.isArray(e))return e}catch(e){return console.warn("Failed to parse metadata:",e),null}return null}static extractGenre(t){if(typeof t.genre=="string")return t.genre;if(Array.isArray(t.genre)&&t.genre.length>0){const r=t.genre[0];return typeof r=="string"?r:""}if(Array.isArray(t.attributes)){const r=t.attributes.find(i=>i.trait_type?.toLowerCase()==="genre"&&i.value!==void 0);if(r){if(typeof r.value=="string")return r.value;if(Array.isArray(r.value)&&r.value.length>0){const i=r.value[0];return typeof i=="string"?i:""}}}if(t.attributes&&typeof t.attributes=="object"&&!Array.isArray(t.attributes)){const r=t.attributes;for(const i of Object.keys(r))if(i.toLowerCase()==="genre"&&typeof r[i]=="string")return r[i]}const e=t["attribute "];if(e&&typeof e=="object"&&!Array.isArray(e)){const r=e.genre;if(typeof r=="string")return r}return""}static extractTags(t){const e=[];if(Array.isArray(t.tags)?e.push(...t.tags):typeof t.tags=="string"&&e.push(...t.tags.split(",")),t.properties&&typeof t.properties=="object"&&!Array.isArray(t.properties)){const r=t.properties.tags;Array.isArray(r)?e.push(...r):typeof r=="string"&&e.push(...r.split(","))}if(Array.isArray(t.attributes))for(const r of t.attributes){if(!r||typeof r!="object")continue;const i=r.trait_type;if(typeof i=="string"&&i.toLowerCase().match(/^tags?$/)){const n=r.value;Array.isArray(n)?e.push(...n):typeof n=="string"&&e.push(...n.split(","))}}else if(t.attributes&&typeof t.attributes=="object"){const r=t.attributes;for(const i of Object.keys(r))if(i.toLowerCase().match(/^tags?$/)){const n=r[i];Array.isArray(n)?e.push(...n):typeof n=="string"&&e.push(...n.split(","))}}return l.normalizeTags(e)}static normalizeTags(t){const e=new Set;for(const r of t){if(r==null)continue;const i=String(r).trim().toLowerCase();i&&e.add(i)}return Array.from(e)}static convertAttributes(t){if(!Array.isArray(t))return null;const e={};for(const r of t)r.trait_type&&r.value!==void 0&&(e[r.trait_type]=r.value);return Object.keys(e).length>0?e:null}static extractNestedUri(t,...e){let r=t;for(const i of e)if(r&&typeof r=="object"&&!Array.isArray(r))r=r[i];else return null;return typeof r=="string"?r:null}}const u=["ipfs.io","cloudflare-ipfs.com","dweb.link","gateway.pinata.cloud","ipfs.infura.io","nftstorage.link","web3-music-pipeline.mypinata.cloud","soundxyz.mypinata.cloud","gold-broad-gibbon-29.mypinata.cloud","bonfire.mypinata.cloud","spinamp.mypinata.cloud","catalogworks.b-cdn.net","www.heds.cloud"],c="ipfs.io",f="/ipfs/";function y(s){if(!s||typeof s!="string")return null;if(s.startsWith("ipfs://ipfs/"))return s.slice(12);if(s.startsWith("ipfs://"))return s.slice(7);try{const t=new URL(s),{hostname:e,pathname:r}=t,i=e.match(/^([A-Za-z0-9]+)\.ipfs\.dweb\.link$/);if(i)return`${i[1]}${r}`;if(u.some(a=>e===a||e.endsWith("."+a))&&r.startsWith(f))return r.slice(f.length)}catch{}return null}function p(s){if(!s||typeof s!="string")return!1;if(s.startsWith("ipfs://"))return!0;try{const t=new URL(s),{hostname:e,pathname:r}=t;if(/^[A-Za-z0-9]+\.ipfs\.dweb\.link$/.test(e)||u.some(n=>e===n||e.endsWith("."+n))&&r.startsWith(f))return!0}catch{}return!1}function g(s){if(!(!s||s.startsWith("ipfs://")))try{const{hostname:t}=new URL(s);return u.some(r=>t===r||t.endsWith("."+r))?t:void 0}catch{return}}function A(s,t={}){if(!s)return s;const e=typeof t=="string"?{gatewayHost:t}:t,{gatewayHost:r=c,preserveOriginalGateway:i=!1}=e,n=y(s);if(n){if(i){const a=g(s);if(a)return`https://${a}/ipfs/${n}`}return`https://${r}/ipfs/${n}`}return s}exports.ArweaveGatewayManager=o.ArweaveGatewayManager;exports.DEFAULT_GATEWAYS=o.DEFAULT_GATEWAYS;exports.KNOWN_GATEWAY_HOSTS=o.KNOWN_GATEWAY_HOSTS;exports.arweaveGatewayManager=o.arweaveGatewayManager;exports.constructGatewayUrl=o.constructGatewayUrl;exports.getAllGatewayUrls=o.getAllGatewayUrls;exports.isArweaveUrl=o.isArweaveUrl;exports.parseArweaveUrl=o.parseArweaveUrl;exports.DEFAULT_IPFS_GATEWAY=c;exports.KNOWN_IPFS_GATEWAY_HOSTS=u;exports.MetadataExtractor=l;exports.extractIPFSPath=y;exports.isIPFS=p;exports.resolveIPFSLink=A;

package/dist/gateway.mjs

@@ -0,0 +1,317 @@
+import { A as h, D as b, K as _, a as w, c as v, g as U, i as T, p as k } from "./arweaveGatewayManager-BKUZ1Klm.js";
+class f {
+  /**
+   * Extract primary (compressed) audio URL with priority:
+   * 1. mp3_url (Standard web audio - preferred)
+   * 2. lossy_audio (Compressed)
+   * 3. audio_url (Explicit audio field)
+   * 4. audio (Bare audio field — some platforms use this instead of audio_url)
+   * 5. lossless_audio (High fidelity - larger files)
+   * 6. animation_url (OpenSea standard - often audio, but could be video)
+   * 7. multimedia_url (Alternative media field)
+   */
+  static extractAudioUrl(t) {
+    const e = ["mp3_url", "mp3Url", "lossy_audio", "lossyAudio", "animation_url", "animationUrl", "audio_url", "audioUrl", "lossless_audio", "losslessAudio", "audio", "multimedia_url", "multimediaUrl"];
+    for (const r of e)
+      if (t[r] && typeof t[r] == "string")
+        return t[r];
+    return null;
+  }
+  /**
+   * Extract optional lossless audio URL (uncompressed/high-fidelity source).
+   * Returns a lossless URL only if it differs from the primary audio URL.
+   * Priority: lossless_audio > animation_url (only if it looks like a lossless format)
+   */
+  static extractAudioUrlLossless(t) {
+    const e = ["lossless_audio", "losslessAudio", "wav_url", "wavUrl", "flac_url", "flacUrl", "audio_url", "audioUrl"];
+    for (const r of e)
+      if (t[r] && typeof t[r] == "string")
+        return t[r];
+    return null;
+  }
+  /**
+   * Extract image URL with priority:
+   *
+   * Flat fields:
+   * 1. image_small (Preferred for performance)
+   * 2. image (Standard)
+   * 3. image_url (Explicit image URL variant)
+   * 4. image_large (Fallback)
+   * 5. image_uri (URI variant)
+   * 6. image_preview (Preview variant)
+   * 7. image_thumb (Last resort)
+   *
+   * Nested object fields (checked if no flat match found):
+   * 8. artwork.uri (Nina Protocol structured artwork)
+   * 9. project.artwork.uri (Project-level artwork)
+   * 10. primaryMedia.uri (Primary media field)
+   */
+  static extractImageUrl(t) {
+    const e = ["image_small", "imageSmall", "image", "image_large", "imageLarge", "image_thumb", "imageThumb", "image_url", "imageUrl", "image_uri", "imageUri", "image_preview", "imagePreview"];
+    for (const i of e)
+      if (t[i] && typeof t[i] == "string")
+        return t[i];
+    const r = [
+      this.extractNestedUri(t, "artwork", "uri"),
+      this.extractNestedUri(t, "project", "artwork", "uri"),
+      this.extractNestedUri(t, "primaryMedia", "uri")
+    ];
+    for (const i of r)
+      if (i) return i;
+    return null;
+  }
+  /**
+   * Extract thumbnail image URL directly from image_thumb fields.
+   * Unlike extractImageUrl, this specifically targets thumbnail fields only.
+   * Priority: image_thumb_url > image_thumb
+   */
+  static extractImageThumbUrl(t) {
+    return t.image_thumb_url && typeof t.image_thumb_url == "string" ? t.image_thumb_url : t.image_thumb && typeof t.image_thumb == "string" ? t.image_thumb : null;
+  }
+  /**
+   * Extract name/title with priority (see specs/001-core-engine/SPEC.md):
+   * 1. name
+   * 2. title
+   */
+  static extractTitle(t) {
+    return t.name && typeof t.name == "string" ? t.name : t.title && typeof t.title == "string" ? t.title : null;
+  }
+  /**
+   * Extract artist with priority (see specs/001-core-engine/SPEC.md):
+   * 1. artist
+   * 2. created_by
+   * 3. minter
+   * 4. OpenSea-style attributes array with trait_type "Artist"
+   */
+  static extractArtist(t) {
+    const e = ["artist", "artist_name", "artistName", "album_artist", "albumArtist", "created_by", "createdBy", "minter"];
+    for (const r of e)
+      if (t[r] && typeof t[r] == "string")
+        return t[r];
+    if (Array.isArray(t.attributes)) {
+      const r = t.attributes.find(
+        (i) => i.trait_type?.toLowerCase() === "artist" && i.value !== void 0
+      );
+      if (r && typeof r.value == "string")
+        return r.value;
+    }
+    return null;
+  }
+  /**
+   * Parse metadata string to JSON object
+   * Handles stringified JSON with error handling
+   */
+  static parseMetadata(t) {
+    if (!t)
+      return null;
+    if (typeof t == "object" && !Array.isArray(t))
+      return t;
+    if (typeof t == "string")
+      try {
+        const e = JSON.parse(t);
+        if (typeof e == "object" && !Array.isArray(e))
+          return e;
+      } catch (e) {
+        return console.warn("Failed to parse metadata:", e), null;
+      }
+    return null;
+  }
+  /**
+   * Extract genre with support for string or array formats.
+   * Sources are checked in priority order; first non-empty wins:
+   * - `genre` field as a string
+   * - `genre` field as an array (first element)
+   * - OpenSea `attributes` array with `trait_type` of "genre" (case-insensitive)
+   * - `attributes` as an object keyed by trait name (e.g. `attributes.Genre`)
+   * - malformed `attribute ` key (literal trailing space) with `.genre`
+   * Stays strict: only fields literally named "genre" are considered
+   * (no fallback to `category` or similar).
+   */
+  static extractGenre(t) {
+    if (typeof t.genre == "string")
+      return t.genre;
+    if (Array.isArray(t.genre) && t.genre.length > 0) {
+      const r = t.genre[0];
+      return typeof r == "string" ? r : "";
+    }
+    if (Array.isArray(t.attributes)) {
+      const r = t.attributes.find(
+        (i) => i.trait_type?.toLowerCase() === "genre" && i.value !== void 0
+      );
+      if (r) {
+        if (typeof r.value == "string")
+          return r.value;
+        if (Array.isArray(r.value) && r.value.length > 0) {
+          const i = r.value[0];
+          return typeof i == "string" ? i : "";
+        }
+      }
+    }
+    if (t.attributes && typeof t.attributes == "object" && !Array.isArray(t.attributes)) {
+      const r = t.attributes;
+      for (const i of Object.keys(r))
+        if (i.toLowerCase() === "genre" && typeof r[i] == "string")
+          return r[i];
+    }
+    const e = t["attribute "];
+    if (e && typeof e == "object" && !Array.isArray(e)) {
+      const r = e.genre;
+      if (typeof r == "string")
+        return r;
+    }
+    return "";
+  }
+  /**
+   * Extract tags from track metadata, normalized to a deduped,
+   * lowercased, trimmed string[] with empties removed.
+   * Sources (concatenated, then deduped):
+   * - `tags` field as an array, or a single comma-separated string
+   * - `properties.tags` array (when `properties` is an object)
+   * - OpenSea `attributes` array with `trait_type` of "tag"/"tags" (case-insensitive)
+   * - `attributes` as an object keyed by trait name (e.g. `attributes.Tags`)
+   */
+  static extractTags(t) {
+    const e = [];
+    if (Array.isArray(t.tags) ? e.push(...t.tags) : typeof t.tags == "string" && e.push(...t.tags.split(",")), t.properties && typeof t.properties == "object" && !Array.isArray(t.properties)) {
+      const r = t.properties.tags;
+      Array.isArray(r) ? e.push(...r) : typeof r == "string" && e.push(...r.split(","));
+    }
+    if (Array.isArray(t.attributes))
+      for (const r of t.attributes) {
+        if (!r || typeof r != "object") continue;
+        const i = r.trait_type;
+        if (typeof i == "string" && i.toLowerCase().match(/^tags?$/)) {
+          const n = r.value;
+          Array.isArray(n) ? e.push(...n) : typeof n == "string" && e.push(...n.split(","));
+        }
+      }
+    else if (t.attributes && typeof t.attributes == "object") {
+      const r = t.attributes;
+      for (const i of Object.keys(r))
+        if (i.toLowerCase().match(/^tags?$/)) {
+          const n = r[i];
+          Array.isArray(n) ? e.push(...n) : typeof n == "string" && e.push(...n.split(","));
+        }
+    }
+    return f.normalizeTags(e);
+  }
+  /**
+   * Normalize a list of raw tag values into a deduped, lowercased,
+   * trimmed string[] with empties removed.
+   */
+  static normalizeTags(t) {
+    const e = /* @__PURE__ */ new Set();
+    for (const r of t) {
+      if (r == null) continue;
+      const i = String(r).trim().toLowerCase();
+      i && e.add(i);
+    }
+    return Array.from(e);
+  }
+  static convertAttributes(t) {
+    if (!Array.isArray(t))
+      return null;
+    const e = {};
+    for (const r of t)
+      r.trait_type && r.value !== void 0 && (e[r.trait_type] = r.value);
+    return Object.keys(e).length > 0 ? e : null;
+  }
+  /**
+   * Safely extract a URI string from a nested object path.
+   * e.g. extractNestedUri(data, 'project', 'artwork', 'uri') => data.project.artwork.uri
+   */
+  static extractNestedUri(t, ...e) {
+    let r = t;
+    for (const i of e)
+      if (r && typeof r == "object" && !Array.isArray(r))
+        r = r[i];
+      else
+        return null;
+    return typeof r == "string" ? r : null;
+  }
+}
+const u = [
+  "ipfs.io",
+  "cloudflare-ipfs.com",
+  "dweb.link",
+  "gateway.pinata.cloud",
+  "ipfs.infura.io",
+  "nftstorage.link",
+  "web3-music-pipeline.mypinata.cloud",
+  "soundxyz.mypinata.cloud",
+  "gold-broad-gibbon-29.mypinata.cloud",
+  "bonfire.mypinata.cloud",
+  "spinamp.mypinata.cloud",
+  "catalogworks.b-cdn.net",
+  "www.heds.cloud"
+], l = "ipfs.io", a = "/ipfs/";
+function c(s) {
+  if (!s || typeof s != "string") return null;
+  if (s.startsWith("ipfs://ipfs/"))
+    return s.slice(12);
+  if (s.startsWith("ipfs://"))
+    return s.slice(7);
+  try {
+    const t = new URL(s), { hostname: e, pathname: r } = t, i = e.match(/^([A-Za-z0-9]+)\.ipfs\.dweb\.link$/);
+    if (i)
+      return `${i[1]}${r}`;
+    if (u.some(
+      (o) => e === o || e.endsWith("." + o)
+    ) && r.startsWith(a))
+      return r.slice(a.length);
+  } catch {
+  }
+  return null;
+}
+function y(s) {
+  if (!s || typeof s != "string") return !1;
+  if (s.startsWith("ipfs://")) return !0;
+  try {
+    const t = new URL(s), { hostname: e, pathname: r } = t;
+    if (/^[A-Za-z0-9]+\.ipfs\.dweb\.link$/.test(e) || u.some(
+      (n) => e === n || e.endsWith("." + n)
+    ) && r.startsWith(a)) return !0;
+  } catch {
+  }
+  return !1;
+}
+function p(s) {
+  if (!(!s || s.startsWith("ipfs://")))
+    try {
+      const { hostname: t } = new URL(s);
+      return u.some(
+        (r) => t === r || t.endsWith("." + r)
+      ) ? t : void 0;
+    } catch {
+      return;
+    }
+}
+function g(s, t = {}) {
+  if (!s) return s;
+  const e = typeof t == "string" ? { gatewayHost: t } : t, { gatewayHost: r = l, preserveOriginalGateway: i = !1 } = e, n = c(s);
+  if (n) {
+    if (i) {
+      const o = p(s);
+      if (o)
+        return `https://${o}/ipfs/${n}`;
+    }
+    return `https://${r}/ipfs/${n}`;
+  }
+  return s;
+}
+export {
+  h as ArweaveGatewayManager,
+  b as DEFAULT_GATEWAYS,
+  l as DEFAULT_IPFS_GATEWAY,
+  _ as KNOWN_GATEWAY_HOSTS,
+  u as KNOWN_IPFS_GATEWAY_HOSTS,
+  f as MetadataExtractor,
+  w as arweaveGatewayManager,
+  v as constructGatewayUrl,
+  c as extractIPFSPath,
+  U as getAllGatewayUrls,
+  T as isArweaveUrl,
+  y as isIPFS,
+  k as parseArweaveUrl,
+  g as resolveIPFSLink
+};