@audd/sdk 1.5.13 → 1.5.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -104,7 +104,7 @@ console.log(song?.spotify?.uri); // spotify:track:...
104
104
  console.log(song?.previewUrl()); // first preview across requested providers, or null
105
105
  ```
106
106
 
107
- Valid `returnMetadata` values: `apple_music`, `spotify`, `deezer`, `napster`,
107
+ Valid `returnMetadata` values: `apple_music`, `spotify`, `deezer`,
108
108
  `musicbrainz`. Blocks are `undefined` when not requested.
109
109
 
110
110
  `streamingUrl(provider)` prefers the direct provider URL when you
@@ -135,8 +135,8 @@ The same `extraParameters` field is on `RecognizeEnterpriseOptions`, `SetCallbac
135
135
 
136
136
  ## Long files (enterprise)
137
137
 
138
- `recognizeEnterprise` accepts files up to several hours and returns a
139
- flat array of matches:
138
+ `recognizeEnterprise` scans the whole file and returns a flat array of
139
+ matches:
140
140
 
141
141
  ```ts
142
142
  const matches = await audd.recognizeEnterprise("./show.mp3", { limit: 20 });
package/dist/index.cjs CHANGED
@@ -25,7 +25,7 @@ function _interopNamespace(e) {
25
25
  var path__namespace = /*#__PURE__*/_interopNamespace(path);
26
26
 
27
27
  // src/version.ts
28
- var VERSION = "1.5.13";
28
+ var VERSION = "1.5.14";
29
29
 
30
30
  // src/errors.ts
31
31
  var AudDError = class extends Error {
@@ -155,7 +155,7 @@ function brandedMessageOf(result) {
155
155
  if (typeof r.title === "string" && r.title.length > 0) parts.push(r.title);
156
156
  return parts.length === 0 ? null : parts.join(" \u2014 ");
157
157
  }
158
- var CUSTOM_CATALOG_PREFIX = "Adding songs to your custom catalog requires enterprise access that isn't enabled on your account.\n\nNote: the custom-catalog endpoint is for adding songs to your private fingerprint database, not for music recognition. If you intended to identify music, use recognize(...) (or recognizeEnterprise(...) for files longer than 25 seconds) instead.\n\nTo request custom-catalog access, contact api@audd.io.\n\n";
158
+ var CUSTOM_CATALOG_PREFIX = "Adding songs to your custom catalog requires enterprise access that isn't enabled on your account.\n\nNote: the custom-catalog endpoint is for adding songs to your private fingerprint database, not for music recognition. If you intended to identify music, use recognize(...) (or recognizeEnterprise(...) to scan beyond the first 12 seconds of a file) instead.\n\nTo request custom-catalog access, contact api@audd.io.\n\n";
159
159
  function raiseFromErrorResponse(body, opts) {
160
160
  const code = body.error?.error_code ?? 0;
161
161
  const message = body.error?.error_message ?? "";
@@ -1372,8 +1372,8 @@ var CustomCatalog = class {
1372
1372
  onEvent;
1373
1373
  /**
1374
1374
  * **This is NOT how you submit audio for music recognition.** For
1375
- * recognition, use `audd.recognize()` (or `audd.recognizeEnterprise()` for
1376
- * files longer than 25 seconds). This method adds a song to your
1375
+ * recognition, use `audd.recognize()` (or `audd.recognizeEnterprise()` to scan
1376
+ * beyond the first 12 seconds of a file). This method adds a song to your
1377
1377
  * **private fingerprint catalog** so AudD's recognition can later identify
1378
1378
  * *your own* tracks for *your account only*. Requires special access —
1379
1379
  * contact api@audd.io if you need it enabled.
@@ -1629,7 +1629,8 @@ var AudD = class {
1629
1629
  return this._advanced;
1630
1630
  }
1631
1631
  /**
1632
- * Recognize a short audio clip (≤25s) from a URL, file path, Blob, or bytes.
1632
+ * Recognize a song from an audio clip given as a URL, file path, Blob, or
1633
+ * bytes; only the first 12 seconds are analyzed.
1633
1634
  *
1634
1635
  * Returns `null` when the server returns `status=success` with `result=null`
1635
1636
  * (no match) — distinct from a thrown error.