@juspay/neurolink 10.8.7 → 10.8.9

package/dist/lib/processors/media/AudioProcessor.d.ts

@@ -179,13 +179,12 @@ export declare class AudioProcessor extends BaseFileProcessor<ProcessedAudio> {
     /**
      * Format a duration in seconds to a human-readable string.
      *
-     * @param seconds - Duration in seconds
-     * @returns Formatted string: "M:SS" for < 1 hour, "H:MM:SS" for >= 1 hour
+     * Delegates to the shared formatter so audio and video describe the same
+     * file the same way — this used to render "0:02" where VideoProcessor
+     * rendered "2s".
      *
-     * @example
-     * formatDuration(225)   // "3:45"
-     * formatDuration(3750)  // "1:02:30"
-     * formatDuration(0)     // "0:00"
+     * @param seconds - Duration in seconds
+     * @returns Formatted string: "45s", "3m 45s", "1h 2m 30s"
      */
     private formatDuration;
     /**

package/dist/lib/processors/media/AudioProcessor.js

@@ -40,6 +40,7 @@ import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { withTimeout } from "../../utils/timeout.js";
+import { formatMediaDuration } from "../../utils/mediaDuration.js";
 let _musicMetadata = null;
 async function loadMusicMetadata() {
     if (_musicMetadata) {
@@ -397,7 +398,7 @@ export class AudioProcessor extends BaseFileProcessor {
             textContent: "",
             metadata: {
                 duration: 0,
-                durationFormatted: "0:00",
+                durationFormatted: formatMediaDuration(0),
                 codec: "unknown",
                 lossless: false,
                 fileSize: buffer.length,
@@ -608,26 +609,15 @@ export class AudioProcessor extends BaseFileProcessor {
     /**
      * Format a duration in seconds to a human-readable string.
      *
-     * @param seconds - Duration in seconds
-     * @returns Formatted string: "M:SS" for < 1 hour, "H:MM:SS" for >= 1 hour
+     * Delegates to the shared formatter so audio and video describe the same
+     * file the same way — this used to render "0:02" where VideoProcessor
+     * rendered "2s".
      *
-     * @example
-     * formatDuration(225)   // "3:45"
-     * formatDuration(3750)  // "1:02:30"
-     * formatDuration(0)     // "0:00"
+     * @param seconds - Duration in seconds
+     * @returns Formatted string: "45s", "3m 45s", "1h 2m 30s"
      */
     formatDuration(seconds) {
-        if (!seconds || seconds <= 0) {
-            return "0:00";
-        }
-        const totalSeconds = Math.round(seconds);
-        const hours = Math.floor(totalSeconds / 3600);
-        const minutes = Math.floor((totalSeconds % 3600) / 60);
-        const secs = totalSeconds % 60;
-        if (hours > 0) {
-            return `${hours}:${String(minutes).padStart(2, "0")}:${String(secs).padStart(2, "0")}`;
-        }
-        return `${minutes}:${String(secs).padStart(2, "0")}`;
+        return formatMediaDuration(seconds);
     }
     /**
      * Format bitrate to a human-readable string.

package/dist/lib/processors/media/VideoProcessor.d.ts

@@ -205,6 +205,11 @@ export declare class VideoProcessor extends BaseFileProcessor<ProcessedVideo> {
     /**
      * Format a duration in seconds to a human-readable string.
      *
+     * Delegates to the shared formatter so audio and video agree — see
+     * `formatMediaDuration`. Rounding replaces the previous truncation, so a
+     * 2.6s clip now reads "3s" rather than "2s" and matches what the audio
+     * side reports for the same stream.
+     *
      * @param seconds - Duration in seconds
      * @returns Formatted string (e.g., "1h 23m 45s")
      */

package/dist/lib/processors/media/VideoProcessor.js

@@ -50,6 +50,7 @@ import { join } from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
+import { formatMediaDuration } from "../../utils/mediaDuration.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
@@ -270,7 +271,7 @@ export class VideoProcessor extends BaseFileProcessor {
             keyframes: [],
             metadata: {
                 duration: 0,
-                durationFormatted: "0s",
+                durationFormatted: formatMediaDuration(0),
                 width: 0,
                 height: 0,
                 codec: "unknown",
@@ -908,27 +909,16 @@ export class VideoProcessor extends BaseFileProcessor {
     /**
      * Format a duration in seconds to a human-readable string.
      *
+     * Delegates to the shared formatter so audio and video agree — see
+     * `formatMediaDuration`. Rounding replaces the previous truncation, so a
+     * 2.6s clip now reads "3s" rather than "2s" and matches what the audio
+     * side reports for the same stream.
+     *
      * @param seconds - Duration in seconds
      * @returns Formatted string (e.g., "1h 23m 45s")
      */
     formatDuration(seconds) {
-        if (seconds <= 0) {
-            return "0s";
-        }
-        const hours = Math.floor(seconds / 3600);
-        const minutes = Math.floor((seconds % 3600) / 60);
-        const secs = Math.floor(seconds % 60);
-        const parts = [];
-        if (hours > 0) {
-            parts.push(`${hours}h`);
-        }
-        if (minutes > 0) {
-            parts.push(`${minutes}m`);
-        }
-        if (secs > 0 || parts.length === 0) {
-            parts.push(`${secs}s`);
-        }
-        return parts.join(" ");
+        return formatMediaDuration(seconds);
     }
     /**
      * Get a file extension from FileInfo, falling back to ".mp4".

package/dist/lib/utils/mediaDuration.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared duration formatting for the media processors.
+ *
+ * AudioProcessor and VideoProcessor each carried their own private
+ * `formatDuration`, and they disagreed: the same two-second file rendered as
+ * "0:02" from audio and "2s" from video, and a zero duration as "0:00" versus
+ * "0s". Both strings land in the `textContent` handed to the model, often in
+ * the same request when a video's muxed audio is described alongside it, so
+ * the mismatch reads as two different facts about one file.
+ *
+ * The explicit-unit form wins over the "m:ss" clock form because these strings
+ * are consumed by a language model, not rendered in a player scrubber: "1m 30s"
+ * has exactly one reading, while "1:30" is ambiguous between 1m30s and 1h30m
+ * and has to be disambiguated from context that may not be present.
+ */
+/**
+ * Format a duration in seconds as explicit units — "45s", "1m 30s", "1h 2m 3s".
+ *
+ * Non-finite, negative and zero durations all render as "0s": callers reach
+ * this with a probe failure or a stream that reports no duration, and a
+ * fabricated number would be worse than an obvious zero.
+ */
+export declare function formatMediaDuration(seconds: number): string;

package/dist/lib/utils/mediaDuration.js

@@ -0,0 +1,45 @@
+/**
+ * Shared duration formatting for the media processors.
+ *
+ * AudioProcessor and VideoProcessor each carried their own private
+ * `formatDuration`, and they disagreed: the same two-second file rendered as
+ * "0:02" from audio and "2s" from video, and a zero duration as "0:00" versus
+ * "0s". Both strings land in the `textContent` handed to the model, often in
+ * the same request when a video's muxed audio is described alongside it, so
+ * the mismatch reads as two different facts about one file.
+ *
+ * The explicit-unit form wins over the "m:ss" clock form because these strings
+ * are consumed by a language model, not rendered in a player scrubber: "1m 30s"
+ * has exactly one reading, while "1:30" is ambiguous between 1m30s and 1h30m
+ * and has to be disambiguated from context that may not be present.
+ */
+/**
+ * Format a duration in seconds as explicit units — "45s", "1m 30s", "1h 2m 3s".
+ *
+ * Non-finite, negative and zero durations all render as "0s": callers reach
+ * this with a probe failure or a stream that reports no duration, and a
+ * fabricated number would be worse than an obvious zero.
+ */
+export function formatMediaDuration(seconds) {
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        return "0s";
+    }
+    const total = Math.round(seconds);
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    const secs = total % 60;
+    const parts = [];
+    if (hours > 0) {
+        parts.push(`${hours}h`);
+    }
+    if (minutes > 0) {
+        parts.push(`${minutes}m`);
+    }
+    // Keep the seconds term when it is the only one, so sub-minute durations
+    // never render as an empty string.
+    if (secs > 0 || parts.length === 0) {
+        parts.push(`${secs}s`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=mediaDuration.js.map

package/dist/processors/media/AudioProcessor.d.ts

@@ -179,13 +179,12 @@ export declare class AudioProcessor extends BaseFileProcessor<ProcessedAudio> {
     /**
      * Format a duration in seconds to a human-readable string.
      *
-     * @param seconds - Duration in seconds
-     * @returns Formatted string: "M:SS" for < 1 hour, "H:MM:SS" for >= 1 hour
+     * Delegates to the shared formatter so audio and video describe the same
+     * file the same way — this used to render "0:02" where VideoProcessor
+     * rendered "2s".
      *
-     * @example
-     * formatDuration(225)   // "3:45"
-     * formatDuration(3750)  // "1:02:30"
-     * formatDuration(0)     // "0:00"
+     * @param seconds - Duration in seconds
+     * @returns Formatted string: "45s", "3m 45s", "1h 2m 30s"
      */
     private formatDuration;
     /**

package/dist/processors/media/AudioProcessor.js

@@ -40,6 +40,7 @@ import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { withTimeout } from "../../utils/timeout.js";
+import { formatMediaDuration } from "../../utils/mediaDuration.js";
 let _musicMetadata = null;
 async function loadMusicMetadata() {
     if (_musicMetadata) {
@@ -397,7 +398,7 @@ export class AudioProcessor extends BaseFileProcessor {
             textContent: "",
             metadata: {
                 duration: 0,
-                durationFormatted: "0:00",
+                durationFormatted: formatMediaDuration(0),
                 codec: "unknown",
                 lossless: false,
                 fileSize: buffer.length,
@@ -608,26 +609,15 @@ export class AudioProcessor extends BaseFileProcessor {
     /**
      * Format a duration in seconds to a human-readable string.
      *
-     * @param seconds - Duration in seconds
-     * @returns Formatted string: "M:SS" for < 1 hour, "H:MM:SS" for >= 1 hour
+     * Delegates to the shared formatter so audio and video describe the same
+     * file the same way — this used to render "0:02" where VideoProcessor
+     * rendered "2s".
      *
-     * @example
-     * formatDuration(225)   // "3:45"
-     * formatDuration(3750)  // "1:02:30"
-     * formatDuration(0)     // "0:00"
+     * @param seconds - Duration in seconds
+     * @returns Formatted string: "45s", "3m 45s", "1h 2m 30s"
      */
     formatDuration(seconds) {
-        if (!seconds || seconds <= 0) {
-            return "0:00";
-        }
-        const totalSeconds = Math.round(seconds);
-        const hours = Math.floor(totalSeconds / 3600);
-        const minutes = Math.floor((totalSeconds % 3600) / 60);
-        const secs = totalSeconds % 60;
-        if (hours > 0) {
-            return `${hours}:${String(minutes).padStart(2, "0")}:${String(secs).padStart(2, "0")}`;
-        }
-        return `${minutes}:${String(secs).padStart(2, "0")}`;
+        return formatMediaDuration(seconds);
     }
     /**
      * Format bitrate to a human-readable string.

package/dist/processors/media/VideoProcessor.d.ts

@@ -205,6 +205,11 @@ export declare class VideoProcessor extends BaseFileProcessor<ProcessedVideo> {
     /**
      * Format a duration in seconds to a human-readable string.
      *
+     * Delegates to the shared formatter so audio and video agree — see
+     * `formatMediaDuration`. Rounding replaces the previous truncation, so a
+     * 2.6s clip now reads "3s" rather than "2s" and matches what the audio
+     * side reports for the same stream.
+     *
      * @param seconds - Duration in seconds
      * @returns Formatted string (e.g., "1h 23m 45s")
      */

package/dist/processors/media/VideoProcessor.js

@@ -50,6 +50,7 @@ import { join } from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
+import { formatMediaDuration } from "../../utils/mediaDuration.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
@@ -270,7 +271,7 @@ export class VideoProcessor extends BaseFileProcessor {
             keyframes: [],
             metadata: {
                 duration: 0,
-                durationFormatted: "0s",
+                durationFormatted: formatMediaDuration(0),
                 width: 0,
                 height: 0,
                 codec: "unknown",
@@ -908,27 +909,16 @@ export class VideoProcessor extends BaseFileProcessor {
     /**
      * Format a duration in seconds to a human-readable string.
      *
+     * Delegates to the shared formatter so audio and video agree — see
+     * `formatMediaDuration`. Rounding replaces the previous truncation, so a
+     * 2.6s clip now reads "3s" rather than "2s" and matches what the audio
+     * side reports for the same stream.
+     *
      * @param seconds - Duration in seconds
      * @returns Formatted string (e.g., "1h 23m 45s")
      */
     formatDuration(seconds) {
-        if (seconds <= 0) {
-            return "0s";
-        }
-        const hours = Math.floor(seconds / 3600);
-        const minutes = Math.floor((seconds % 3600) / 60);
-        const secs = Math.floor(seconds % 60);
-        const parts = [];
-        if (hours > 0) {
-            parts.push(`${hours}h`);
-        }
-        if (minutes > 0) {
-            parts.push(`${minutes}m`);
-        }
-        if (secs > 0 || parts.length === 0) {
-            parts.push(`${secs}s`);
-        }
-        return parts.join(" ");
+        return formatMediaDuration(seconds);
     }
     /**
      * Get a file extension from FileInfo, falling back to ".mp4".

package/dist/utils/mediaDuration.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared duration formatting for the media processors.
+ *
+ * AudioProcessor and VideoProcessor each carried their own private
+ * `formatDuration`, and they disagreed: the same two-second file rendered as
+ * "0:02" from audio and "2s" from video, and a zero duration as "0:00" versus
+ * "0s". Both strings land in the `textContent` handed to the model, often in
+ * the same request when a video's muxed audio is described alongside it, so
+ * the mismatch reads as two different facts about one file.
+ *
+ * The explicit-unit form wins over the "m:ss" clock form because these strings
+ * are consumed by a language model, not rendered in a player scrubber: "1m 30s"
+ * has exactly one reading, while "1:30" is ambiguous between 1m30s and 1h30m
+ * and has to be disambiguated from context that may not be present.
+ */
+/**
+ * Format a duration in seconds as explicit units — "45s", "1m 30s", "1h 2m 3s".
+ *
+ * Non-finite, negative and zero durations all render as "0s": callers reach
+ * this with a probe failure or a stream that reports no duration, and a
+ * fabricated number would be worse than an obvious zero.
+ */
+export declare function formatMediaDuration(seconds: number): string;

package/dist/utils/mediaDuration.js

@@ -0,0 +1,44 @@
+/**
+ * Shared duration formatting for the media processors.
+ *
+ * AudioProcessor and VideoProcessor each carried their own private
+ * `formatDuration`, and they disagreed: the same two-second file rendered as
+ * "0:02" from audio and "2s" from video, and a zero duration as "0:00" versus
+ * "0s". Both strings land in the `textContent` handed to the model, often in
+ * the same request when a video's muxed audio is described alongside it, so
+ * the mismatch reads as two different facts about one file.
+ *
+ * The explicit-unit form wins over the "m:ss" clock form because these strings
+ * are consumed by a language model, not rendered in a player scrubber: "1m 30s"
+ * has exactly one reading, while "1:30" is ambiguous between 1m30s and 1h30m
+ * and has to be disambiguated from context that may not be present.
+ */
+/**
+ * Format a duration in seconds as explicit units — "45s", "1m 30s", "1h 2m 3s".
+ *
+ * Non-finite, negative and zero durations all render as "0s": callers reach
+ * this with a probe failure or a stream that reports no duration, and a
+ * fabricated number would be worse than an obvious zero.
+ */
+export function formatMediaDuration(seconds) {
+    if (!Number.isFinite(seconds) || seconds <= 0) {
+        return "0s";
+    }
+    const total = Math.round(seconds);
+    const hours = Math.floor(total / 3600);
+    const minutes = Math.floor((total % 3600) / 60);
+    const secs = total % 60;
+    const parts = [];
+    if (hours > 0) {
+        parts.push(`${hours}h`);
+    }
+    if (minutes > 0) {
+        parts.push(`${minutes}m`);
+    }
+    // Keep the seconds term when it is the only one, so sub-minute durations
+    // never render as an empty string.
+    if (secs > 0 || parts.length === 0) {
+        parts.push(`${secs}s`);
+    }
+    return parts.join(" ");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.8.7",
+  "version": "10.8.9",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {