playlist-data-engine 1.7.1 → 1.7.3

package/dist/gateway-C_p9Ku3O.js

@@ -0,0 +1,1211 @@
+import { a as F } from "./arweaveGatewayManager-DDSO5sLJ.js";
+class l {
+  /**
+   * 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", "audio_url", "audioUrl", "audio", "lossless_audio", "losslessAudio", "animation_url", "animationUrl", "multimedia_url", "multimediaUrl"];
+    for (const r of e)
+      if (t[r] && typeof t[r] == "string")
+        return t[r];
+    return null;
+  }
+  /**
+   * Extract the highest-fidelity audio URL the track offers — best
+   * available, not a guarantee. A track whose only source is an mp3 gets
+   * that back rather than 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;
+  }
+  /**
+   * 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 s of e)
+      if (t[s] && typeof t[s] == "string")
+        return t[s];
+    const r = [
+      this.extractNestedUri(t, "artwork", "uri"),
+      this.extractNestedUri(t, "project", "artwork", "uri"),
+      this.extractNestedUri(t, "primaryMedia", "uri")
+    ];
+    for (const s of r)
+      if (s) return s;
+    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(
+        (s) => s.trait_type?.toLowerCase() === "artist" && s.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(
+        (s) => s.trait_type?.toLowerCase() === "genre" && s.value !== void 0
+      );
+      if (r) {
+        if (typeof r.value == "string")
+          return r.value;
+        if (Array.isArray(r.value) && r.value.length > 0) {
+          const s = r.value[0];
+          return typeof s == "string" ? s : "";
+        }
+      }
+    }
+    if (t.attributes && typeof t.attributes == "object" && !Array.isArray(t.attributes)) {
+      const r = t.attributes;
+      for (const s of Object.keys(r))
+        if (s.toLowerCase() === "genre" && typeof r[s] == "string")
+          return r[s];
+    }
+    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 s = r.trait_type;
+        if (typeof s == "string" && s.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 s of Object.keys(r))
+        if (s.toLowerCase().match(/^tags?$/)) {
+          const n = r[s];
+          Array.isArray(n) ? e.push(...n) : typeof n == "string" && e.push(...n.split(","));
+        }
+    }
+    return l.normalizeTags(e);
+  }
+  /**
+   * Extract track description with priority:
+   *
+   * Flat fields:
+   * 1. description (Canonical)
+   * 2. track_description / trackDescription (Explicit track-scoped variants)
+   * 3. description_text / descriptionText (Text-suffixed variants)
+   * 4. desc / blurb (Short-form variants)
+   *
+   * Then:
+   * 5. OpenSea-style attributes array with trait_type "description" (case-insensitive)
+   * 6. Deep search fallback — breadth-first walk of nested objects for the
+   *    shallowest key matching /description/i (catches properties.description
+   *    and any other nested home for the field). Arrays are skipped: items
+   *    inside arrays (stems, mixes, attribute entries) carry their own scoped
+   *    descriptions, not the track's.
+   */
+  static extractDescription(t) {
+    const e = ["description", "track_description", "trackDescription", "description_text", "descriptionText", "desc", "blurb"];
+    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(
+        (s) => s.trait_type?.toLowerCase() === "description" && typeof s.value == "string"
+      );
+      if (r && typeof r.value == "string")
+        return r.value;
+    }
+    return l.deepFindString(t, /description/i);
+  }
+  /**
+   * Extract album description — one of the bonus flavors. Priority:
+   *
+   * Flat fields:
+   * 1. album_description (Canonical)
+   * 2. albumDescription (camelCase variant)
+   *
+   * Nested object fields (only when `album` is an object — it is just as
+   * often a plain name string, which yields nothing here):
+   * 3. Deep search scoped to the album object — catches album.description,
+   *    album.liner_notes, album.notes and friends without ever misattributing
+   *    the track's own description to the album.
+   */
+  static extractAlbumDescription(t) {
+    const e = ["album_description", "albumDescription"];
+    for (const s of e)
+      if (t[s] && typeof t[s] == "string")
+        return t[s];
+    const r = t.album;
+    return r && typeof r == "object" && !Array.isArray(r) ? l.deepFindString(r, /description|liner|notes/i) : null;
+  }
+  /**
+   * Extract artist description — one of the bonus flavors. Priority:
+   *
+   * Flat fields:
+   * 1. artist_description (Canonical)
+   * 2. artistDescription (camelCase variant)
+   * 3. artist_bio / artistBio (Bio variants)
+   *
+   * Nested object fields (only when `artist` is an object — it is just as
+   * often a plain name string, which yields nothing here):
+   * 4. Deep search scoped to the artist object — catches artist.description,
+   *    artist.bio, artist.about and friends without ever misattributing the
+   *    track's own description to the artist.
+   */
+  static extractArtistDescription(t) {
+    const e = ["artist_description", "artistDescription", "artist_bio", "artistBio"];
+    for (const s of e)
+      if (t[s] && typeof t[s] == "string")
+        return t[s];
+    const r = t.artist;
+    return r && typeof r == "object" && !Array.isArray(r) ? l.deepFindString(r, /description|bio|about/i) : null;
+  }
+  /**
+   * Breadth-first search for the shallowest string value whose key matches
+   * the given pattern. First match in breadth order wins: shallowest level,
+   * then key order. Objects are descended (arrays skipped), depth-capped so
+   * pathological metadata blobs stay cheap.
+   */
+  static deepFindString(t, e, r = 5) {
+    const s = /* @__PURE__ */ new Set(), n = [{ node: t, depth: 0 }];
+    for (; n.length > 0; ) {
+      const { node: c, depth: a } = n.shift();
+      for (const o of Object.keys(c)) {
+        const u = c[o];
+        if (typeof u == "string" && u && e.test(o))
+          return u;
+      }
+      if (!(a >= r))
+        for (const o of Object.keys(c)) {
+          const u = c[o];
+          u && typeof u == "object" && !Array.isArray(u) && !s.has(u) && (s.add(u), n.push({ node: u, depth: a + 1 }));
+        }
+    }
+    return null;
+  }
+  /**
+   * 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 s = String(r).trim().toLowerCase();
+      s && e.add(s);
+    }
+    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 s of e)
+      if (r && typeof r == "object" && !Array.isArray(r))
+        r = r[s];
+      else
+        return null;
+    return typeof r == "string" ? r : null;
+  }
+}
+function lt(i) {
+  if (!i || !i.metadata) return null;
+  if (typeof i.metadata == "string")
+    try {
+      const t = JSON.parse(i.metadata);
+      return typeof t == "object" && t !== null && !Array.isArray(t) ? t : null;
+    } catch {
+      return null;
+    }
+  return typeof i.metadata == "object" && !Array.isArray(i.metadata) ? i.metadata : null;
+}
+function h(i) {
+  const t = { stems: [], mixes: [], hasExtras: !1 };
+  if (!i) return t;
+  const e = V(i), r = Y(i), s = typeof i.vrm == "string" ? i.vrm : void 0, n = G(i.lyrics), c = b(i.visualizer), a = b(i.video), o = O(i.merch), u = K(i.credits), p = typeof i.midi == "string" ? i.midi : void 0, f = typeof i.step_mania == "string" ? i.step_mania : void 0, m = typeof i.clone_hero == "string" ? i.clone_hero : void 0, d = typeof i.external_url == "string" ? i.external_url : void 0;
+  return {
+    hasExtras: e.length > 0 || r.length > 0 || !!s || !!n || !!c || !!a || !!o || !!u || !!p || !!f || !!m || !!d,
+    ...e.length > 0 ? { stems: e } : {},
+    ...r.length > 0 ? { mixes: r } : {},
+    ...s ? { vrm: s } : {},
+    ...n ? { lyrics: n } : {},
+    ...c ? { visualizer: c } : {},
+    ...a ? { video: a } : {},
+    ...o ? { merch: o } : {},
+    ...u ? { credits: u } : {},
+    ...p ? { midi: p } : {},
+    ...f ? { step_mania: f } : {},
+    ...m ? { clone_hero: m } : {},
+    ...d ? { external_url: d } : {}
+  };
+}
+const w = ["audio/wav", "audio/x-wav", "audio/flac"];
+function M(i, t, e) {
+  const r = t?.["Selected Mix"], s = typeof i == "string" && i || typeof r == "string" && r || null;
+  if (!s || s === "default") return null;
+  const n = (e ?? []).filter((u) => u.name === s);
+  if (n.length === 0) return null;
+  const c = (u) => w.includes((u.mime_type ?? "").toLowerCase()), a = n.find(c), o = n.find((u) => !c(u)) ?? n[0];
+  return {
+    name: s,
+    ...o?.uri ? { audio_url: o.uri } : {},
+    ...a?.uri && a.uri !== o?.uri ? { audio_url_lossless: a.uri } : {}
+  };
+}
+function ft(i, t, e) {
+  if (!i || !t) return null;
+  const r = S(i, t, e?.caseInsensitive !== !1, e?.aliases !== !1);
+  return r.length > 0 ? T(r, e?.prefer ?? "lossy") : null;
+}
+function T(i, t = "lossy") {
+  if (!i || i.length === 0) return null;
+  if (i.length === 1) return i[0];
+  const e = t === "lossy" ? ["audio/mpeg", "audio/wav", "audio/flac"] : ["audio/wav", "audio/flac", "audio/mpeg"];
+  for (const r of e) {
+    const s = i.find((n) => $(n.mime_type) === r);
+    if (s) return s;
+  }
+  return i[0];
+}
+function pt(i) {
+  if (!i || !Array.isArray(i)) return [];
+  const t = /* @__PURE__ */ new Map();
+  for (const e of i) {
+    const r = e.name.trim().toLowerCase(), s = t.get(r);
+    s ? s.push(e) : t.set(r, [e]);
+  }
+  return Array.from(t.values()).map((e) => ({
+    name: e[0].name,
+    mixes: e
+  }));
+}
+async function A(i, t) {
+  if (!i) return null;
+  const e = i, r = e.uri ?? e.audio_url ?? e.audio_url_lossless;
+  if (!r) return null;
+  let s = r;
+  if (t?.followMetadata !== !1 && R(i, r)) {
+    const n = await B(r, t?.fetchTimeoutMs);
+    if (!n) return null;
+    s = n;
+  }
+  if (t?.resolveUrl === !1) return s;
+  try {
+    return await F.resolveUrl(s);
+  } catch {
+    return null;
+  }
+}
+async function mt(i, t, e) {
+  const r = i.extras?.mixes;
+  if (!r || r.length === 0 || !t) return null;
+  let s = S(r, t, !0, e?.aliases !== !1);
+  if (s.length === 0) return null;
+  if (e?.conditionsContext) {
+    const p = Z(
+      { hasExtras: i.extras?.hasExtras ?? !0, mixes: r },
+      e.conditionsContext
+    ), f = new Set(p.filter((m) => m.allMet).map((m) => m.mix.name));
+    if (s = s.filter((m) => f.has(m.name)), s.length === 0) return null;
+  }
+  const n = T(s, e?.prefer ?? "lossy");
+  if (!n || !n.uri) return null;
+  const c = {
+    resolveUrl: e?.resolveUrl,
+    followMetadata: e?.followMetadata
+  }, a = await A(n, c);
+  if (!a) return null;
+  const o = s.find(P), u = o && o !== n && o.uri ? await A(o, c) : void 0;
+  return {
+    ...i,
+    audio_url: a,
+    audio_url_lossless: u && u !== a ? u : void 0,
+    selected_mix: n.name
+  };
+}
+const D = ["application/json", "application/ld+json"], N = {
+  "audio/x-wav": "audio/wav",
+  "audio/wave": "audio/wav",
+  "audio/vnd.wave": "audio/wav",
+  "audio/x-flac": "audio/flac",
+  "audio/mp3": "audio/mpeg",
+  "audio/mpeg3": "audio/mpeg"
+};
+function $(i) {
+  const t = (i ?? "").trim().toLowerCase();
+  return N[t] ?? t;
+}
+function P(i) {
+  return w.includes($(i.mime_type));
+}
+function W(i, t, e) {
+  if (!i || !t) return [];
+  const r = (n) => e ? n.trim().toLowerCase() : n.trim(), s = r(t);
+  return i.filter((n) => r(n.name) === s);
+}
+const H = [
+  ["no vocals", "instrumental"],
+  ["vocals only", "acapella"],
+  ["vocal only", "acapella"],
+  ["a cappella", "acapella"],
+  ["tv mix", "karaoke"],
+  ["tv version", "karaoke"],
+  ["karaoke version", "karaoke"],
+  ["karaoke mix", "karaoke"]
+], z = {
+  inst: "instrumental",
+  instr: "instrumental",
+  instrument: "instrumental",
+  instrumentals: "instrumental",
+  aca: "acapella",
+  acap: "acapella",
+  acappella: "acapella",
+  cappella: "acapella",
+  vox: "acapella",
+  vocal: "acapella",
+  vocals: "acapella",
+  rmx: "remix",
+  tvmix: "karaoke",
+  tv: "karaoke",
+  karoake: "karaoke"
+};
+function x(i) {
+  let t = " " + i.toLowerCase().replace(/[^a-z0-9\s]/g, " ").replace(/\s+/g, " ").trim() + " ";
+  for (const [e, r] of H)
+    t = t.split(" " + e + " ").join(" " + r + " ");
+  return t.trim().split(" ").filter(Boolean).map((e) => z[e] ?? e);
+}
+function S(i, t, e, r) {
+  const s = W(i, t, e);
+  if (s.length > 0 || !r || !e) return s;
+  const n = x(t);
+  return n.length === 0 ? [] : i.filter((c) => {
+    const a = x(c.name);
+    return n.every((o) => a.includes(o));
+  });
+}
+function R(i, t) {
+  const e = ("mime_type" in i ? i.mime_type : "") ?? "";
+  return D.includes(e.toLowerCase()) ? !0 : e ? !1 : t.split(/[?#]/)[0].toLowerCase().endsWith(".json");
+}
+async function B(i, t = 1e4) {
+  const e = new AbortController(), r = setTimeout(() => e.abort(), t);
+  try {
+    const s = await fetch(i, { signal: e.signal });
+    if (!s.ok) return null;
+    const n = l.parseMetadata(await s.text());
+    return n ? l.extractAudioUrl(n) : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(r);
+  }
+}
+function G(i) {
+  if (i) {
+    if (typeof i == "string") return { text: i };
+    if (typeof i == "object" && !Array.isArray(i)) {
+      const t = i;
+      return { text: typeof t.text == "string" ? t.text : void 0 };
+    }
+  }
+}
+function b(i) {
+  if (!i || typeof i != "object" || Array.isArray(i)) return;
+  const t = i;
+  if (typeof t.uri == "string")
+    return {
+      uri: t.uri,
+      mime_type: typeof t.mime_type == "string" ? t.mime_type : void 0
+    };
+}
+function O(i) {
+  if (!i || typeof i != "object" || Array.isArray(i)) return;
+  const t = i;
+  if (typeof t.uri == "string")
+    return {
+      uri: t.uri,
+      mime_type: typeof t.mime_type == "string" ? t.mime_type : void 0,
+      type: typeof t.type == "string" ? t.type : void 0
+    };
+}
+function K(i) {
+  if (!Array.isArray(i)) return;
+  const t = [];
+  for (const e of i)
+    if (e && typeof e == "object") {
+      const r = e;
+      typeof r.name == "string" && typeof r.credit == "string" && t.push({ name: r.name, credit: r.credit });
+    }
+  return t.length > 0 ? t : void 0;
+}
+function V(i) {
+  const t = i.stems;
+  if (!Array.isArray(t)) return [];
+  const e = [];
+  for (const r of t)
+    if (r && typeof r == "object") {
+      const s = r;
+      e.push({
+        name: typeof s.name == "string" ? s.name : "",
+        uri: typeof s.uri == "string" ? s.uri : void 0,
+        mime_type: typeof s.mime_type == "string" ? s.mime_type : void 0
+      });
+    }
+  return e;
+}
+function Y(i) {
+  const t = i.mixes;
+  if (!Array.isArray(t)) return [];
+  const e = [];
+  for (const r of t)
+    if (r && typeof r == "object") {
+      const s = r, n = q(s.name), c = J(s.conditions);
+      e.push({
+        name: n || "",
+        uri: typeof s.uri == "string" ? s.uri : void 0,
+        mime_type: typeof s.mime_type == "string" ? s.mime_type : void 0,
+        conditions: c
+      });
+    }
+  return e;
+}
+function q(i) {
+  if (typeof i == "string") return i;
+  if (i && typeof i == "object" && !Array.isArray(i)) {
+    const t = i;
+    if (typeof t.value == "string") return t.value;
+  }
+  return "";
+}
+function J(i) {
+  if (!Array.isArray(i)) return [];
+  const t = [];
+  for (const e of i)
+    if (e && typeof e == "object") {
+      const r = e;
+      typeof r.type == "string" && (typeof r.value == "string" || typeof r.value == "number" || typeof r.value == "boolean") && t.push({ type: r.type, value: String(r.value) });
+    }
+  return t;
+}
+function Z(i, t) {
+  const e = [], r = /* @__PURE__ */ new Date();
+  for (const s of i.mixes || []) {
+    if (s.conditions.length === 0) {
+      e.push({
+        mix: s,
+        conditions: [],
+        allMet: !0,
+        unmetConditions: []
+      });
+      continue;
+    }
+    const n = [], c = [];
+    for (const a of s.conditions) {
+      const o = Q(a, t, r);
+      n.push(o), o.met || c.push(o);
+    }
+    e.push({
+      mix: s,
+      conditions: n,
+      allMet: c.length === 0,
+      unmetConditions: c
+    });
+  }
+  return e;
+}
+function Q(i, t, e = /* @__PURE__ */ new Date()) {
+  const { type: r, value: s } = i, n = t?.environment, c = t?.appState;
+  switch (r) {
+    case "weather": {
+      const a = n?.weather?.weatherType || "", o = a.toLowerCase() === s.toLowerCase();
+      return {
+        type: r,
+        value: s,
+        met: o,
+        reason: o ? `Weather is ${a}` : `Weather is ${a} (need ${s})`
+      };
+    }
+    case "day": {
+      const o = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"][e.getDay()], u = o.toLowerCase() === s.toLowerCase();
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Today is ${o}` : `Today is ${o} (need ${s})`
+      };
+    }
+    case "start_time": {
+      const a = e.getHours() * 60 + e.getMinutes(), o = k(s), u = a >= o;
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Time is after ${s}` : `Time is before ${s}`
+      };
+    }
+    case "end_time": {
+      const a = e.getHours() * 60 + e.getMinutes(), o = k(s), u = a < o;
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Time is before ${s}` : `Time is after ${s}`
+      };
+    }
+    case "min_plays": {
+      const a = parseInt(s, 10), o = c?.playCount ?? 0, u = o >= a;
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Played ${o} times (need ${a})` : `Played ${o} times (need ${a})`
+      };
+    }
+    case "max_plays": {
+      const a = parseInt(s, 10), o = c?.playCount ?? 0, u = o <= a;
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Played ${o} times (max ${a})` : `Played ${o} times (exceeds max ${a})`
+      };
+    }
+    case "every_x_plays": {
+      const a = parseInt(s, 10), o = c?.playCount ?? 0, u = a > 0 && o > 0 && o % a === 0;
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Play #${o} (every ${a} plays)` : `Play #${o} (not a multiple of ${a})`
+      };
+    }
+    case "altitude": {
+      const a = n?.geolocation?.altitude;
+      if (a == null)
+        return { type: r, value: s, met: !1, reason: "Altitude unavailable" };
+      const o = X(s), u = tt(a, o.operator, o.threshold);
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? `Altitude ${a}m ${o.operator} ${o.threshold}m` : `Altitude ${a}m (need ${o.operator} ${o.threshold}m)`
+      };
+    }
+    case "favorite": {
+      const a = c?.isFavorite ?? !1, o = s.toLowerCase() === "true", u = a === o;
+      return {
+        type: r,
+        value: s,
+        met: u,
+        reason: u ? a ? "Track is favorited" : "Track is not favorited" : a ? "Track is favorited (need unfavorited)" : "Track is not favorited (need favorited)"
+      };
+    }
+    case "birthday": {
+      if (!c?.userBirthday)
+        return { type: r, value: s, met: !1, reason: "Birthday not set" };
+      const o = `${String(e.getMonth() + 1).padStart(2, "0")}-${String(e.getDate()).padStart(2, "0")}` === c.userBirthday;
+      return {
+        type: r,
+        value: s,
+        met: o,
+        reason: o ? "It's your birthday!" : `Not your birthday (need ${c.userBirthday})`
+      };
+    }
+    case "weight":
+      return {
+        type: r,
+        value: s,
+        met: !0,
+        reason: `Weight ${s} (used for random selection, always available)`
+      };
+    default:
+      return {
+        type: r,
+        value: s,
+        met: !0,
+        reason: `Custom condition: ${r} = ${s}`
+      };
+  }
+}
+function k(i) {
+  const t = i.split(":");
+  if (t.length !== 2) return 0;
+  const e = parseInt(t[0], 10), r = parseInt(t[1], 10);
+  return isNaN(e) || isNaN(r) ? 0 : e * 60 + r;
+}
+function X(i) {
+  const t = i.match(/^(>=|<=|>|<|=)?\s*(\d+(?:\.\d+)?)\s*$/);
+  return t ? {
+    operator: t[1] || ">=",
+    threshold: parseFloat(t[2])
+  } : { operator: ">=", threshold: parseFloat(i) || 0 };
+}
+function tt(i, t, e) {
+  switch (t) {
+    case ">":
+      return i > e;
+    case ">=":
+      return i >= e;
+    case "<":
+      return i < e;
+    case "<=":
+      return i <= e;
+    case "=":
+    case "==":
+      return i === e;
+    default:
+      return i >= e;
+  }
+}
+function y(i) {
+  if ("audio_url" in i && typeof i.audio_url == "string")
+    return i.audio_url;
+  if ("metadata" in i) {
+    const t = l.parseMetadata(i.metadata);
+    if (t)
+      return l.extractAudioUrl(t);
+  }
+  return null;
+}
+function U(i) {
+  if ("audio_url_lossless" in i && typeof i.audio_url_lossless == "string")
+    return i.audio_url_lossless;
+  if ("metadata" in i) {
+    const t = l.parseMetadata(i.metadata);
+    if (t)
+      return l.extractAudioUrlLossless(t);
+  }
+  return null;
+}
+function _(i) {
+  if ("image_url" in i && typeof i.image_url == "string")
+    return i.image_url;
+  if ("metadata" in i) {
+    if ("artwork_url" in i && typeof i.artwork_url == "string")
+      return i.artwork_url;
+    const t = l.parseMetadata(i.metadata);
+    if (t)
+      return l.extractImageUrl(t);
+  }
+  return null;
+}
+function L(i) {
+  if ("image_thumb_url" in i && typeof i.image_thumb_url == "string")
+    return i.image_thumb_url;
+  if ("metadata" in i) {
+    const t = l.parseMetadata(i.metadata);
+    if (t)
+      return l.extractImageThumbUrl(t);
+  }
+  return null;
+}
+function C(i) {
+  if ("metadata" in i) {
+    const t = l.parseMetadata(i.metadata);
+    if (t && typeof t.vrm == "string" && t.vrm)
+      return t.vrm;
+  }
+  return "extras" in i && i.extras && typeof i.extras.vrm == "string" && i.extras.vrm || null;
+}
+function j(i) {
+  if ("extras" in i && i.extras?.mixes)
+    return i.extras.mixes;
+  if ("metadata" in i) {
+    const t = l.parseMetadata(i.metadata);
+    if (t)
+      return h(t).mixes ?? [];
+  }
+  return [];
+}
+function E(i) {
+  if ("audio_url" in i || !("metadata" in i))
+    return null;
+  const t = l.parseMetadata(i.metadata);
+  return M(
+    i.selected_mix,
+    l.convertAttributes(t?.attributes),
+    t ? h(t).mixes : void 0
+  );
+}
+function dt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    const r = y(e);
+    r && t.push(r);
+  }
+  return t;
+}
+function yt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    const r = _(e);
+    r && t.push(r);
+  }
+  return t;
+}
+function _t(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    if ("title" in e && typeof e.title == "string") {
+      t.push(e.title);
+      continue;
+    }
+    if ("metadata" in e) {
+      const r = l.parseMetadata(e.metadata);
+      if (r) {
+        const s = l.extractTitle(r);
+        s && t.push(s);
+      }
+    }
+  }
+  return t;
+}
+function gt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    if ("artist" in e && typeof e.artist == "string") {
+      t.push(e.artist);
+      continue;
+    }
+    if ("metadata" in e) {
+      const r = l.parseMetadata(e.metadata);
+      if (r) {
+        const s = l.extractArtist(r);
+        s && t.push(s);
+      }
+    }
+  }
+  return t;
+}
+function ht(i) {
+  const t = /* @__PURE__ */ new Set();
+  for (const e of i.tracks) {
+    if ("genre" in e && typeof e.genre == "string" && e.genre) {
+      t.add(e.genre);
+      continue;
+    }
+    if ("metadata" in e) {
+      const r = l.parseMetadata(e.metadata);
+      r && typeof r.genre == "string" && r.genre && t.add(r.genre);
+    }
+  }
+  return Array.from(t).sort();
+}
+function vt(i) {
+  const t = /* @__PURE__ */ new Set();
+  for (const e of i.tracks) {
+    if ("tags" in e && Array.isArray(e.tags)) {
+      for (const r of e.tags)
+        r && t.add(r.toLowerCase());
+      continue;
+    }
+    if ("metadata" in e) {
+      const r = l.parseMetadata(e.metadata);
+      if (r && Array.isArray(r.tags))
+        for (const s of r.tags)
+          s && t.add(String(s).toLowerCase());
+    }
+  }
+  return Array.from(t).sort();
+}
+function At(i) {
+  let t = 0;
+  for (const e of i.tracks) {
+    if ("duration" in e && typeof e.duration == "number") {
+      t += e.duration;
+      continue;
+    }
+    if ("metadata" in e) {
+      const r = l.parseMetadata(e.metadata);
+      r && typeof r.duration == "number" && (t += r.duration);
+    }
+  }
+  return t;
+}
+function xt(i) {
+  return i.tracks.length;
+}
+function bt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    let r = y(e);
+    const s = _(e), n = L(e), c = E(e);
+    c?.audio_url && (r = c.audio_url);
+    const a = c ? c.name : "audio_url" in e ? e.selected_mix : void 0;
+    let o = "", u = "", p;
+    if ("title" in e)
+      o = e.title || "", u = e.artist || "", p = e.description || void 0;
+    else if ("metadata" in e) {
+      const f = l.parseMetadata(e.metadata);
+      f && (o = l.extractTitle(f) || "", u = l.extractArtist(f) || "", p = l.extractDescription(f) || void 0);
+    }
+    if (r) {
+      const f = {
+        title: o,
+        artist: u,
+        audio_url: r,
+        image_url: s || ""
+      }, m = U(e), d = c ? c.audio_url_lossless : m && m !== r ? m : void 0;
+      d && (f.audio_url_lossless = d), a && (f.selected_mix = a), n && (f.image_thumb_url = n), p && (f.description = p), "audio_ipfs_hash" in e && typeof e.audio_ipfs_hash == "string" && (f.audio_ipfs_hash = e.audio_ipfs_hash), "artwork_ipfs_hash" in e && typeof e.artwork_ipfs_hash == "string" && (f.artwork_ipfs_hash = e.artwork_ipfs_hash), "mint_function" in e && typeof e.mint_function == "string" && (f.mint_function = e.mint_function), "mint_price" in e && typeof e.mint_price == "string" && (f.mint_price = e.mint_price), "mint_snapshot_time" in e && typeof e.mint_snapshot_time == "number" && (f.mint_snapshot_time = e.mint_snapshot_time), "mint_token" in e && typeof e.mint_token == "string" && (f.mint_token = e.mint_token), t.push(f);
+    }
+  }
+  return t;
+}
+function kt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    if ("audio_url" in e) {
+      t.push({ ...e });
+      continue;
+    }
+    if ("metadata" in e) {
+      const r = l.parseMetadata(e.metadata);
+      if (r) {
+        const s = h(r), n = M(
+          e.selected_mix,
+          l.convertAttributes(r.attributes),
+          s.mixes
+        ), c = l.extractAudioUrlLossless(r), a = l.extractAudioUrl(r), o = n?.audio_url || a, u = n ? n.audio_url_lossless : c && c !== o ? c : void 0;
+        t.push({
+          id: e.chain_name === "AR" ? `AR-${e.tx_id}` : `${e.chain_name}-${e.token_address}-${e.token_id}`,
+          chain_name: e.chain_name,
+          token_address: e.token_address,
+          token_id: e.token_id,
+          tx_id: e.tx_id,
+          platform: e.platform,
+          title: l.extractTitle(r),
+          artist: l.extractArtist(r),
+          audio_url: o,
+          image_url: l.extractImageUrl(r),
+          image_thumb_url: l.extractImageThumbUrl(r),
+          duration: r.duration,
+          genre: r.genre,
+          tags: r.tags,
+          bpm: r.bpm,
+          key: r.key,
+          album: r.album,
+          description: l.extractDescription(r),
+          attributes: l.convertAttributes(r.attributes),
+          ...u ? { audio_url_lossless: u } : {},
+          ...n ? { selected_mix: n.name } : {},
+          ...s.hasExtras ? { extras: s } : {},
+          // v0.4 IPFS hash + mint fields from the raw track wrapper
+          ...e.audio_ipfs_hash ? { audio_ipfs_hash: e.audio_ipfs_hash } : {},
+          ...e.artwork_ipfs_hash ? { artwork_ipfs_hash: e.artwork_ipfs_hash } : {},
+          ...e.mint_function ? { mint_function: e.mint_function } : {},
+          ...e.mint_price ? { mint_price: e.mint_price } : {},
+          ...e.mint_snapshot_time ? { mint_snapshot_time: e.mint_snapshot_time } : {},
+          ...e.mint_token ? { mint_token: e.mint_token } : {}
+        });
+      }
+    }
+  }
+  return t;
+}
+function wt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    const r = C(e);
+    r && t.push(r);
+  }
+  return t;
+}
+function Mt(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    const r = C(e);
+    if (!r) continue;
+    const s = y(e), n = _(e), c = L(e);
+    let a = "", o = "", u;
+    if ("title" in e)
+      a = e.title || "", o = e.artist || "", u = e.description || void 0;
+    else if ("metadata" in e) {
+      const f = l.parseMetadata(e.metadata);
+      f && (a = l.extractTitle(f) || "", o = l.extractArtist(f) || "", u = l.extractDescription(f) || void 0);
+    }
+    const p = {
+      title: a,
+      artist: o,
+      audio_url: s || "",
+      image_url: n || "",
+      vrm: r
+    };
+    c && (p.image_thumb_url = c), u && (p.description = u), t.push(p);
+  }
+  return t;
+}
+function Tt(i) {
+  const t = [];
+  for (const e of i.tracks)
+    t.push(...j(e));
+  return t;
+}
+function $t(i) {
+  const t = [];
+  for (const e of i.tracks) {
+    const r = j(e);
+    if (r.length === 0) continue;
+    const s = E(e);
+    let n = "", c = "", a;
+    if ("title" in e)
+      n = e.title || "", c = e.artist || "", a = e.description || void 0;
+    else if ("metadata" in e) {
+      const f = l.parseMetadata(e.metadata);
+      f && (n = l.extractTitle(f) || "", c = l.extractArtist(f) || "", a = l.extractDescription(f) || void 0);
+    }
+    let o = y(e) || "", u;
+    if (s)
+      o = s.audio_url || o, u = s.audio_url_lossless;
+    else {
+      const f = U(e);
+      u = f && f !== o ? f : void 0;
+    }
+    const p = s ? s.name : "audio_url" in e ? e.selected_mix : void 0;
+    t.push({
+      title: n,
+      artist: c,
+      audio_url: o,
+      image_url: _(e) || "",
+      ...u ? { audio_url_lossless: u } : {},
+      ...p ? { selected_mix: p } : {},
+      ...a ? { description: a } : {},
+      mixes: r
+    });
+  }
+  return t;
+}
+const v = [
+  "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"
+], et = "ipfs.io", g = "/ipfs/", rt = /^Qm[1-9A-HJ-NP-Za-km-z]{44}$/, it = /^b[a-z2-7]{55,}$/;
+function st(i) {
+  return rt.test(i) || it.test(i);
+}
+const nt = /^ipfs_[a-z]+$/;
+function I(i) {
+  const t = i.split("/").filter(Boolean);
+  for (let e = 0; e < t.length - 1; e++)
+    if (nt.test(t[e]) && st(t[e + 1])) {
+      const r = t[e + 1], s = t.slice(e + 2);
+      return s.length > 0 ? `${r}/${s.join("/")}` : r;
+    }
+  return null;
+}
+function ot(i) {
+  if (!i || typeof i != "string") return null;
+  if (i.startsWith("ipfs://ipfs/"))
+    return i.slice(12);
+  if (i.startsWith("ipfs://"))
+    return i.slice(7);
+  try {
+    const t = new URL(i), { hostname: e, pathname: r } = t, s = e.match(/^([A-Za-z0-9]+)\.ipfs\.dweb\.link$/);
+    if (s)
+      return `${s[1]}${r}`;
+    if (v.some(
+      (a) => e === a || e.endsWith("." + a)
+    ) && r.startsWith(g))
+      return r.slice(g.length);
+    const c = I(r);
+    if (c) return c;
+  } catch {
+  }
+  return null;
+}
+function St(i) {
+  if (!i || typeof i != "string") return !1;
+  if (i.startsWith("ipfs://")) return !0;
+  try {
+    const t = new URL(i), { hostname: e, pathname: r } = t;
+    if (/^[A-Za-z0-9]+\.ipfs\.dweb\.link$/.test(e) || v.some(
+      (n) => e === n || e.endsWith("." + n)
+    ) && r.startsWith(g) || I(r)) return !0;
+  } catch {
+  }
+  return !1;
+}
+function at(i) {
+  if (!(!i || i.startsWith("ipfs://")))
+    try {
+      const { hostname: t } = new URL(i);
+      return v.some(
+        (r) => t === r || t.endsWith("." + r)
+      ) ? t : void 0;
+    } catch {
+      return;
+    }
+}
+function Ut(i, t = {}) {
+  if (!i) return i;
+  const e = typeof t == "string" ? { gatewayHost: t } : t, { gatewayHost: r = et, preserveOriginalGateway: s = !1 } = e, n = ot(i);
+  if (n) {
+    if (s) {
+      const c = at(i);
+      if (c)
+        return `https://${c}/ipfs/${n}`;
+    }
+    return `https://${r}/ipfs/${n}`;
+  }
+  return i;
+}
+export {
+  et as D,
+  v as K,
+  l as M,
+  ot as a,
+  gt as b,
+  dt as c,
+  kt as d,
+  Z as e,
+  ft as f,
+  h as g,
+  ht as h,
+  yt as i,
+  $t as j,
+  Tt as k,
+  T as l,
+  vt as m,
+  At as n,
+  xt as o,
+  lt as p,
+  _t as q,
+  M as r,
+  bt as s,
+  pt as t,
+  Mt as u,
+  wt as v,
+  St as w,
+  Ut as x,
+  A as y,
+  mt as z
+};