playlist-data-engine 1.5.8 → 1.5.9

package/dist/playlist-data-engine.mjs

@@ -40781,76 +40781,91 @@ class I0 {
   /**
    * Analyzes audio to extract genre, mood, and vibe data.
    */
+  /**
+   * Analyze a track. Accepts either:
+   *   - a `string` URL: the engine fetches + decodes + downsamples via Web
+   *     Audio (main-thread path). Backward-compatible with all existing callers.
+   *   - an `{ audioSignal, sampleRate? }` object: caller has already fetched,
+   *     decoded, AND downsampled to mono PCM. Used when running inside a Web
+   *     Worker (no Web Audio available there). `sampleRate` defaults to 16000
+   *     (essentia.js's required rate); the engine skips fetch + decode +
+   *     downsample and runs only the slice + ML inference on the provided signal.
+   */
   async analyze(e) {
     try {
       await this.initializeEssentia();
-      const i = await (await fetch(e)).arrayBuffer(), n = new (window.AudioContext || window.webkitAudioContext)(), a = await n.decodeAudioData(i), r = await this.extractor.downsampleAudioBuffer(
-        a,
-        n.sampleRate
-      ), o = this.sliceAudioSignal(r, 16e3), c = Math.max(0, Math.floor((o.length - 512) / 256) + 1), l = [], u = {
+      let t;
+      if (typeof e == "string") {
+        const l = await (await fetch(e)).arrayBuffer(), u = typeof self < "u" ? self : typeof globalThis < "u" ? globalThis : {}, d = u.AudioContext || u.webkitAudioContext, h = u.OfflineAudioContext || u.webkitOfflineAudioContext, m = d ? new d() : h ? new h(1, 44100, 44100) : (() => {
+          throw new Error("No Web Audio API available in this context");
+        })(), f = await m.decodeAudioData(l);
+        t = await this.extractor.downsampleAudioBuffer(f, m.sampleRate);
+      } else
+        t = e.audioSignal;
+      const i = this.sliceAudioSignal(t, 16e3), n = Math.max(0, Math.floor((i.length - 512) / 256) + 1), a = [], r = {
         genres: [],
         moods: [],
         mood_tags: [],
         vibe_metrics: {}
       };
       if (this.options.models?.genre) {
-        const d = this.options.models.genre, h = Ai(d) ? d.classifier : d.modelUrl;
-        let m;
-        Ai(d) && d.classifierType ? m = d.classifierType : fr(d) && d.genreType ? m = d.genreType : m = dv(h);
-        const f = hv(m);
-        u.genres = await this.runModelPrediction(
-          d,
+        const o = this.options.models.genre, c = Ai(o) ? o.classifier : o.modelUrl;
+        let l;
+        Ai(o) && o.classifierType ? l = o.classifierType : fr(o) && o.genreType ? l = o.genreType : l = dv(c);
+        const u = hv(l);
+        r.genres = await this.runModelPrediction(
           o,
-          f
-        ), u.primary_genre = u.genres.length > 0 ? u.genres[0].name : "Unknown", l.push(Ot(d));
+          i,
+          u
+        ), r.primary_genre = r.genres.length > 0 ? r.genres[0].name : "Unknown", a.push(Ot(o));
       }
       if (this.options.models?.mood) {
-        const d = this.options.models.mood, h = fr(d) ? rv : ov;
-        u.moods = await this.runModelPrediction(
-          d,
+        const o = this.options.models.mood, c = fr(o) ? rv : ov;
+        r.moods = await this.runModelPrediction(
           o,
-          h
-        ), u.mood_tags = u.moods.slice(0, 3).map((m) => m.name), l.push(Ot(d));
+          i,
+          c
+        ), r.mood_tags = r.moods.slice(0, 3).map((l) => l.name), a.push(Ot(o));
       }
       if (this.options.models?.danceability) {
-        const d = this.options.models.danceability, m = (await this.runModelPrediction(
-          d,
+        const o = this.options.models.danceability, l = (await this.runModelPrediction(
           o,
+          i,
           cv
-        )).find((f) => f.name === "danceable");
-        u.vibe_metrics.danceability = m?.confidence ?? 0, l.push(Ot(d));
+        )).find((u) => u.name === "danceable");
+        r.vibe_metrics.danceability = l?.confidence ?? 0, a.push(Ot(o));
       }
       if (this.options.models?.voice) {
-        const d = this.options.models.voice, m = (await this.runModelPrediction(
-          d,
+        const o = this.options.models.voice, l = (await this.runModelPrediction(
           o,
+          i,
           lv
-        )).find((f) => f.name === "instrumental");
-        u.vibe_metrics.instrumental_probability = m?.confidence ?? 0, l.push(Ot(d));
+        )).find((u) => u.name === "instrumental");
+        r.vibe_metrics.instrumental_probability = l?.confidence ?? 0, a.push(Ot(o));
       }
       if (this.options.models?.acoustic) {
-        const d = this.options.models.acoustic, m = (await this.runModelPrediction(
-          d,
+        const o = this.options.models.acoustic, l = (await this.runModelPrediction(
           o,
+          i,
           uv
-        )).find((f) => f.name === "electronic");
-        u.vibe_metrics.electronic_probability = m?.confidence ?? 0, l.push(Ot(d));
+        )).find((u) => u.name === "electronic");
+        r.vibe_metrics.electronic_probability = l?.confidence ?? 0, a.push(Ot(o));
       }
-      if (u.moods) {
-        const d = u.moods.find((m) => m.name === "energetic" || m.name === "upbeat" || m.name === "epic"), h = u.moods.find((m) => m.name === "happy" || m.name === "positive" || m.name === "uplifting");
-        d && (u.vibe_metrics.energy = d.confidence), h && (u.vibe_metrics.valence = h.confidence);
+      if (r.moods) {
+        const o = r.moods.find((l) => l.name === "energetic" || l.name === "upbeat" || l.name === "epic"), c = r.moods.find((l) => l.name === "happy" || l.name === "positive" || l.name === "uplifting");
+        o && (r.vibe_metrics.energy = o.confidence), c && (r.vibe_metrics.valence = c.confidence);
       }
       return {
-        genres: u.genres || [],
-        moods: u.moods || [],
-        primary_genre: u.primary_genre || "Unknown",
-        mood_tags: u.mood_tags || [],
-        vibe_metrics: u.vibe_metrics,
+        genres: r.genres || [],
+        moods: r.moods || [],
+        primary_genre: r.primary_genre || "Unknown",
+        mood_tags: r.mood_tags || [],
+        vibe_metrics: r.vibe_metrics,
         analysis_metadata: {
-          models_used: l,
-          model_used: l.length > 0 ? l[0] : void 0,
-          frames_analyzed: c,
-          duration_analyzed: o.length / 16e3,
+          models_used: a,
+          model_used: a.length > 0 ? a[0] : void 0,
+          frames_analyzed: n,
+          duration_analyzed: i.length / 16e3,
           analyzed_at: (/* @__PURE__ */ new Date()).toISOString()
         }
       };

package/package.json

@@ -6,7 +6,7 @@
     "type": "git",
     "url": "git+https://github.com/jasondesante/playlist-data-engine.git"
   },
-  "version": "1.5.8",
+  "version": "1.5.9",
   "type": "module",
   "main": "./dist/playlist-data-engine.js",
   "module": "./dist/playlist-data-engine.mjs",