@audd/sdk 1.5.10 → 1.5.11

package/README.md

@@ -145,10 +145,15 @@ for (const m of matches) {
 }
 ```
 
-`EnterpriseMatch` carries the same core tags plus `score`, `startOffset`,
-`endOffset`, `isrc`, `upc`. Access to `isrc`, `upc`, and `score` requires
-a Startup plan or higher — [contact us](mailto:api@audd.io) for enterprise
-features.
+`EnterpriseMatch` carries the same core tags plus `score`, `startSeconds`,
+`endSeconds`, `startOffset`, `endOffset`, `isrc`, `upc`. `startSeconds` and
+`endSeconds` are where this song plays in your file, in seconds (e.g. 64.2 to
+71.8) — feed straight to a player or ffmpeg; computed while parsing the chunked
+response, and `recognizeEnterprise` requests accurate offsets by default so
+they're precise. `startOffset`/`endOffset` are the raw millisecond positions
+within AudD's internal 12-second scan fragment behind them. Access to `isrc`,
+`upc`, and `score` requires a Startup plan or higher — [contact
+us](mailto:api@audd.io) for enterprise features.
 
 The default per-call timeout is **1 hour** for this endpoint (60s for
 standard recognition); override with `timeoutMs`.

package/dist/index.cjs

@@ -285,6 +285,20 @@ function asNumber(v) {
 function asBoolean(v) {
   return typeof v === "boolean" ? v : void 0;
 }
+function parseOffsetToSeconds(o) {
+  if (o === void 0 || o === null) return void 0;
+  if (typeof o === "number") return Number.isFinite(o) ? o : void 0;
+  const t = String(o).trim();
+  if (t === "") return void 0;
+  let total = 0;
+  for (const part of t.split(":")) {
+    if (part.trim() === "") return void 0;
+    const n = Number(part);
+    if (!Number.isFinite(n)) return void 0;
+    total = total * 60 + n;
+  }
+  return total;
+}
 var STREAMING_PROVIDERS = [
   "spotify",
   "apple_music",
@@ -434,7 +448,9 @@ var ENTERPRISE_MATCH_KEYS = [
   "upc",
   "song_link",
   "start_offset",
-  "end_offset"
+  "end_offset",
+  "start_seconds",
+  "end_seconds"
 ];
 function parseEnterpriseMatch(raw) {
   const r = requireObject(raw, "EnterpriseMatch");
@@ -454,6 +470,8 @@ function parseEnterpriseMatch(raw) {
     songLink,
     startOffset: asNumber(r.start_offset),
     endOffset: asNumber(r.end_offset),
+    startSeconds: void 0,
+    endSeconds: void 0,
     extras: pickExtras(r, ENTERPRISE_MATCH_KEYS),
     rawResponse: r,
     streamingUrl(provider) {
@@ -488,8 +506,17 @@ function parseEnterpriseChunkResult(raw) {
   const r = requireObject(raw, "EnterpriseChunkResult");
   const songsRaw = Array.isArray(r.songs) ? r.songs : [];
   const offset = asString(r.offset);
+  const base = parseOffsetToSeconds(r.offset);
+  const songs = songsRaw.map((s) => {
+    const match = parseEnterpriseMatch(s);
+    if (base !== void 0) {
+      match.startSeconds = base + (match.startOffset ?? 0) / 1e3;
+      match.endSeconds = base + (match.endOffset ?? 0) / 1e3;
+    }
+    return match;
+  });
   return {
-    songs: songsRaw.map(parseEnterpriseMatch),
+    songs,
     offset,
     extras: pickExtras(r, ENTERPRISE_CHUNK_KEYS),
     rawResponse: r
@@ -1376,8 +1403,8 @@ function buildEnterpriseFields(opts) {
   if (opts.skipFirstSeconds !== void 0)
     fields["skip_first_seconds"] = String(opts.skipFirstSeconds);
   if (opts.useTimecode !== void 0) fields["use_timecode"] = opts.useTimecode ? "true" : "false";
-  if (opts.accurateOffsets !== void 0)
-    fields["accurate_offsets"] = opts.accurateOffsets ? "true" : "false";
+  const accurate = opts.accurateOffsets ?? true;
+  fields["accurate_offsets"] = accurate ? "true" : "false";
   return fields;
 }
 function isDeprecationPassThrough(body) {