@juspay/neurolink 9.55.9 → 9.55.10

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

@@ -36,10 +36,27 @@
  * }
  * ```
  */
-import { parseBuffer, selectCover } from "music-metadata";
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
+let _musicMetadata = null;
+async function loadMusicMetadata() {
+    if (_musicMetadata) {
+        return _musicMetadata;
+    }
+    try {
+        _musicMetadata = await import(/* @vite-ignore */ "music-metadata");
+        return _musicMetadata;
+    }
+    catch (err) {
+        const e = err instanceof Error ? err : null;
+        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
+            e.message.includes("music-metadata")) {
+            throw new Error('Audio processing requires the "music-metadata" package. Install it with:\n  pnpm add music-metadata', { cause: err });
+        }
+        throw err;
+    }
+}
 // =============================================================================
 // TYPES
 // =============================================================================
@@ -239,7 +256,7 @@ export class AudioProcessor extends BaseFileProcessor {
             // Step 5: Extract tags from common metadata
             const tags = this.extractTags(audioMetadata);
             // Step 6: Extract embedded cover art if present
-            const coverArt = this.extractCoverArt(audioMetadata);
+            const coverArt = await this.extractCoverArt(audioMetadata);
             // Step 7: Attempt transcription if API key is available
             const filename = this.getFilename(fileInfo);
             const transcriptionResult = await this.attemptTranscription(buffer, filename, fileInfo.mimetype);
@@ -404,6 +421,7 @@ export class AudioProcessor extends BaseFileProcessor {
         // parseBuffer accepts (Uint8Array, fileInfo?: IFileInfo | string, options?)
         // where string is interpreted as MIME type.
         const mimeType = fileInfo.mimetype || undefined;
+        const { parseBuffer } = await loadMusicMetadata();
         return parseBuffer(buffer, mimeType);
     }
     /**
@@ -467,11 +485,12 @@ export class AudioProcessor extends BaseFileProcessor {
      * @param audioMetadata - Parsed audio metadata from music-metadata
      * @returns Cover art as Buffer, or null if no cover art is embedded
      */
-    extractCoverArt(audioMetadata) {
+    async extractCoverArt(audioMetadata) {
         const pictures = audioMetadata.common.picture;
         if (!pictures || pictures.length === 0) {
             return null;
         }
+        const { selectCover } = await loadMusicMetadata();
         const cover = selectCover(pictures);
         if (!cover) {
             return null;

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

@@ -44,9 +44,7 @@
  * ```
  */
 import { randomUUID } from "crypto";
-import ffmpegCommand from "fluent-ffmpeg";
 import { createWriteStream, existsSync, promises as fs } from "fs";
-import { Input, FilePathSource, ALL_FORMATS } from "mediabunny";
 import { tmpdir } from "os";
 import { join } from "path";
 import { Readable } from "stream";
@@ -56,6 +54,40 @@ import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
 import { logger } from "../../utils/logger.js";
+// fluent-ffmpeg's default export is callable + has static methods — avoid caching
+// the module type (it confuses TS); Node's module cache handles dedup.
+async function loadFluentFfmpeg() {
+    try {
+        const mod = await import(/* @vite-ignore */ "fluent-ffmpeg");
+        return mod.default;
+    }
+    catch (err) {
+        const e = err instanceof Error ? err : null;
+        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
+            e.message.includes("fluent-ffmpeg")) {
+            throw new Error('Video processing requires the "fluent-ffmpeg" package. Install it with:\n  pnpm add fluent-ffmpeg', { cause: err });
+        }
+        throw err;
+    }
+}
+let _mediabunny = null;
+async function loadMediaBunny() {
+    if (_mediabunny) {
+        return _mediabunny;
+    }
+    try {
+        _mediabunny = await import(/* @vite-ignore */ "mediabunny");
+        return _mediabunny;
+    }
+    catch (err) {
+        const e = err instanceof Error ? err : null;
+        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
+            e.message.includes("mediabunny")) {
+            throw new Error('Video processing requires the "mediabunny" package. Install it with:\n  pnpm add mediabunny', { cause: err });
+        }
+        throw err;
+    }
+}
 // =============================================================================
 // FFMPEG PATH INITIALIZATION
 // =============================================================================
@@ -90,7 +122,8 @@ async function initFfmpegPaths() {
         const ffmpegStatic = await import("ffmpeg-static");
         const ffmpegPath = ffmpegStatic.default;
         if (typeof ffmpegPath === "string" && existsSync(ffmpegPath)) {
-            ffmpegCommand.setFfmpegPath(ffmpegPath);
+            const ff = await loadFluentFfmpeg();
+            ff.setFfmpegPath(ffmpegPath);
         }
     }
     catch {
@@ -469,7 +502,8 @@ export class VideoProcessor extends BaseFileProcessor {
      * @param filePath - Path to the video file
      * @returns Success result with probe data or error message
      */
-    probeVideo(filePath) {
+    async probeVideo(filePath) {
+        const ffmpeg = await loadFluentFfmpeg();
         return new Promise((resolve) => {
             const timeoutId = setTimeout(() => {
                 resolve({
@@ -477,7 +511,7 @@ export class VideoProcessor extends BaseFileProcessor {
                     error: `ffprobe timed out after ${VIDEO_CONFIG.FFPROBE_TIMEOUT_MS}ms`,
                 });
             }, VIDEO_CONFIG.FFPROBE_TIMEOUT_MS);
-            ffmpegCommand.ffprobe(filePath, (err, data) => {
+            ffmpeg.ffprobe(filePath, (err, data) => {
                 clearTimeout(timeoutId);
                 if (err) {
                     resolve({
@@ -496,11 +530,12 @@ export class VideoProcessor extends BaseFileProcessor {
      * Falls back to ffprobe if mediabunny fails or doesn't support the format.
      */
     async probeVideoWithMediabunny(filePath) {
+        const mb = await loadMediaBunny();
         let input;
         try {
-            input = new Input({
-                source: new FilePathSource(filePath),
-                formats: [...ALL_FORMATS],
+            input = new mb.Input({
+                source: new mb.FilePathSource(filePath),
+                formats: [...mb.ALL_FORMATS],
             });
             const duration = await input.computeDuration();
             const videoTrack = await input.getPrimaryVideoTrack();
@@ -671,7 +706,8 @@ export class VideoProcessor extends BaseFileProcessor {
      * @param outputDir - Directory to write frame files
      * @param timestamps - Array of timestamps in seconds
      */
-    runFfmpegFrameExtraction(videoPath, outputDir, timestamps, intervalSec) {
+    async runFfmpegFrameExtraction(videoPath, outputDir, timestamps, intervalSec) {
+        const ff = await loadFluentFfmpeg();
         return new Promise((resolve, reject) => {
             // Improved select expression to pick exactly one frame per interval
             // instead of multiple frames within a 0.5s window.
@@ -679,7 +715,7 @@ export class VideoProcessor extends BaseFileProcessor {
             const timeoutId = setTimeout(() => {
                 reject(new Error(`ffmpeg frame extraction timed out after ${VIDEO_CONFIG.FFMPEG_TIMEOUT_MS}ms`));
             }, VIDEO_CONFIG.FFMPEG_TIMEOUT_MS);
-            ffmpegCommand(videoPath)
+            ff(videoPath)
                 .outputOptions([
                 "-vf",
                 `select='${selectExpr}',scale='min(${VIDEO_CONFIG.FRAME_MAX_DIMENSION}\\,iw):-2'`,
@@ -740,11 +776,12 @@ export class VideoProcessor extends BaseFileProcessor {
      */
     async extractSubtitles(videoPath, tempDir) {
         const subtitlePath = join(tempDir, "subtitles.srt");
+        const ffSub = await loadFluentFfmpeg();
         await new Promise((resolve, reject) => {
             const timeoutId = setTimeout(() => {
                 reject(new Error(`ffmpeg subtitle extraction timed out after ${VIDEO_CONFIG.FFMPEG_TIMEOUT_MS}ms`));
             }, VIDEO_CONFIG.FFMPEG_TIMEOUT_MS);
-            ffmpegCommand(videoPath)
+            ffSub(videoPath)
                 .outputOptions(["-map", "0:s:0", "-c:s", "srt"])
                 .output(subtitlePath)
                 .on("end", () => {

package/dist/lib/types/processor.d.ts

@@ -543,6 +543,33 @@ export type ProcessedYaml = ProcessedFileBase & {
     /** YAML content converted to JSON string for AI consumption */
     asJson: string | null;
 };
+/**
+ * Structural types for fluent-ffmpeg probe data.
+ * Defined here so the optional fluent-ffmpeg package is not required at typecheck time.
+ */
+export type FfprobeStream = {
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    r_frame_rate?: string;
+    avg_frame_rate?: string;
+    bit_rate?: number | string;
+    channels?: number;
+    sample_rate?: number | string;
+    tags?: Record<string, string | number>;
+    [key: string]: unknown;
+};
+export type FfprobeData = {
+    streams: FfprobeStream[];
+    format: {
+        duration?: number;
+        size?: number | string;
+        bit_rate?: number | string;
+        tags?: Record<string, string | number>;
+        [key: string]: unknown;
+    };
+};
 /**
  * Structural types for exceljs objects.
  * Defined here so the optional exceljs package is not required at typecheck time.

package/dist/processors/media/AudioProcessor.js

@@ -36,10 +36,27 @@
  * }
  * ```
  */
-import { parseBuffer, selectCover } from "music-metadata";
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
+let _musicMetadata = null;
+async function loadMusicMetadata() {
+    if (_musicMetadata) {
+        return _musicMetadata;
+    }
+    try {
+        _musicMetadata = await import(/* @vite-ignore */ "music-metadata");
+        return _musicMetadata;
+    }
+    catch (err) {
+        const e = err instanceof Error ? err : null;
+        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
+            e.message.includes("music-metadata")) {
+            throw new Error('Audio processing requires the "music-metadata" package. Install it with:\n  pnpm add music-metadata', { cause: err });
+        }
+        throw err;
+    }
+}
 // =============================================================================
 // TYPES
 // =============================================================================
@@ -239,7 +256,7 @@ export class AudioProcessor extends BaseFileProcessor {
             // Step 5: Extract tags from common metadata
             const tags = this.extractTags(audioMetadata);
             // Step 6: Extract embedded cover art if present
-            const coverArt = this.extractCoverArt(audioMetadata);
+            const coverArt = await this.extractCoverArt(audioMetadata);
             // Step 7: Attempt transcription if API key is available
             const filename = this.getFilename(fileInfo);
             const transcriptionResult = await this.attemptTranscription(buffer, filename, fileInfo.mimetype);
@@ -404,6 +421,7 @@ export class AudioProcessor extends BaseFileProcessor {
         // parseBuffer accepts (Uint8Array, fileInfo?: IFileInfo | string, options?)
         // where string is interpreted as MIME type.
         const mimeType = fileInfo.mimetype || undefined;
+        const { parseBuffer } = await loadMusicMetadata();
         return parseBuffer(buffer, mimeType);
     }
     /**
@@ -467,11 +485,12 @@ export class AudioProcessor extends BaseFileProcessor {
      * @param audioMetadata - Parsed audio metadata from music-metadata
      * @returns Cover art as Buffer, or null if no cover art is embedded
      */
-    extractCoverArt(audioMetadata) {
+    async extractCoverArt(audioMetadata) {
         const pictures = audioMetadata.common.picture;
         if (!pictures || pictures.length === 0) {
             return null;
         }
+        const { selectCover } = await loadMusicMetadata();
         const cover = selectCover(pictures);
         if (!cover) {
             return null;

package/dist/processors/media/VideoProcessor.js

@@ -44,9 +44,7 @@
  * ```
  */
 import { randomUUID } from "crypto";
-import ffmpegCommand from "fluent-ffmpeg";
 import { createWriteStream, existsSync, promises as fs } from "fs";
-import { Input, FilePathSource, ALL_FORMATS } from "mediabunny";
 import { tmpdir } from "os";
 import { join } from "path";
 import { Readable } from "stream";
@@ -56,6 +54,40 @@ import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 import { tracers, ATTR, withSpan } from "../../telemetry/index.js";
 import { logger } from "../../utils/logger.js";
+// fluent-ffmpeg's default export is callable + has static methods — avoid caching
+// the module type (it confuses TS); Node's module cache handles dedup.
+async function loadFluentFfmpeg() {
+    try {
+        const mod = await import(/* @vite-ignore */ "fluent-ffmpeg");
+        return mod.default;
+    }
+    catch (err) {
+        const e = err instanceof Error ? err : null;
+        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
+            e.message.includes("fluent-ffmpeg")) {
+            throw new Error('Video processing requires the "fluent-ffmpeg" package. Install it with:\n  pnpm add fluent-ffmpeg', { cause: err });
+        }
+        throw err;
+    }
+}
+let _mediabunny = null;
+async function loadMediaBunny() {
+    if (_mediabunny) {
+        return _mediabunny;
+    }
+    try {
+        _mediabunny = await import(/* @vite-ignore */ "mediabunny");
+        return _mediabunny;
+    }
+    catch (err) {
+        const e = err instanceof Error ? err : null;
+        if (e?.code === "ERR_MODULE_NOT_FOUND" &&
+            e.message.includes("mediabunny")) {
+            throw new Error('Video processing requires the "mediabunny" package. Install it with:\n  pnpm add mediabunny', { cause: err });
+        }
+        throw err;
+    }
+}
 // =============================================================================
 // FFMPEG PATH INITIALIZATION
 // =============================================================================
@@ -90,7 +122,8 @@ async function initFfmpegPaths() {
         const ffmpegStatic = await import("ffmpeg-static");
         const ffmpegPath = ffmpegStatic.default;
         if (typeof ffmpegPath === "string" && existsSync(ffmpegPath)) {
-            ffmpegCommand.setFfmpegPath(ffmpegPath);
+            const ff = await loadFluentFfmpeg();
+            ff.setFfmpegPath(ffmpegPath);
         }
     }
     catch {
@@ -469,7 +502,8 @@ export class VideoProcessor extends BaseFileProcessor {
      * @param filePath - Path to the video file
      * @returns Success result with probe data or error message
      */
-    probeVideo(filePath) {
+    async probeVideo(filePath) {
+        const ffmpeg = await loadFluentFfmpeg();
         return new Promise((resolve) => {
             const timeoutId = setTimeout(() => {
                 resolve({
@@ -477,7 +511,7 @@ export class VideoProcessor extends BaseFileProcessor {
                     error: `ffprobe timed out after ${VIDEO_CONFIG.FFPROBE_TIMEOUT_MS}ms`,
                 });
             }, VIDEO_CONFIG.FFPROBE_TIMEOUT_MS);
-            ffmpegCommand.ffprobe(filePath, (err, data) => {
+            ffmpeg.ffprobe(filePath, (err, data) => {
                 clearTimeout(timeoutId);
                 if (err) {
                     resolve({
@@ -496,11 +530,12 @@ export class VideoProcessor extends BaseFileProcessor {
      * Falls back to ffprobe if mediabunny fails or doesn't support the format.
      */
     async probeVideoWithMediabunny(filePath) {
+        const mb = await loadMediaBunny();
         let input;
         try {
-            input = new Input({
-                source: new FilePathSource(filePath),
-                formats: [...ALL_FORMATS],
+            input = new mb.Input({
+                source: new mb.FilePathSource(filePath),
+                formats: [...mb.ALL_FORMATS],
             });
             const duration = await input.computeDuration();
             const videoTrack = await input.getPrimaryVideoTrack();
@@ -671,7 +706,8 @@ export class VideoProcessor extends BaseFileProcessor {
      * @param outputDir - Directory to write frame files
      * @param timestamps - Array of timestamps in seconds
      */
-    runFfmpegFrameExtraction(videoPath, outputDir, timestamps, intervalSec) {
+    async runFfmpegFrameExtraction(videoPath, outputDir, timestamps, intervalSec) {
+        const ff = await loadFluentFfmpeg();
         return new Promise((resolve, reject) => {
             // Improved select expression to pick exactly one frame per interval
             // instead of multiple frames within a 0.5s window.
@@ -679,7 +715,7 @@ export class VideoProcessor extends BaseFileProcessor {
             const timeoutId = setTimeout(() => {
                 reject(new Error(`ffmpeg frame extraction timed out after ${VIDEO_CONFIG.FFMPEG_TIMEOUT_MS}ms`));
             }, VIDEO_CONFIG.FFMPEG_TIMEOUT_MS);
-            ffmpegCommand(videoPath)
+            ff(videoPath)
                 .outputOptions([
                 "-vf",
                 `select='${selectExpr}',scale='min(${VIDEO_CONFIG.FRAME_MAX_DIMENSION}\\,iw):-2'`,
@@ -740,11 +776,12 @@ export class VideoProcessor extends BaseFileProcessor {
      */
     async extractSubtitles(videoPath, tempDir) {
         const subtitlePath = join(tempDir, "subtitles.srt");
+        const ffSub = await loadFluentFfmpeg();
         await new Promise((resolve, reject) => {
             const timeoutId = setTimeout(() => {
                 reject(new Error(`ffmpeg subtitle extraction timed out after ${VIDEO_CONFIG.FFMPEG_TIMEOUT_MS}ms`));
             }, VIDEO_CONFIG.FFMPEG_TIMEOUT_MS);
-            ffmpegCommand(videoPath)
+            ffSub(videoPath)
                 .outputOptions(["-map", "0:s:0", "-c:s", "srt"])
                 .output(subtitlePath)
                 .on("end", () => {

package/dist/types/processor.d.ts

@@ -543,6 +543,33 @@ export type ProcessedYaml = ProcessedFileBase & {
     /** YAML content converted to JSON string for AI consumption */
     asJson: string | null;
 };
+/**
+ * Structural types for fluent-ffmpeg probe data.
+ * Defined here so the optional fluent-ffmpeg package is not required at typecheck time.
+ */
+export type FfprobeStream = {
+    codec_type?: string;
+    codec_name?: string;
+    width?: number;
+    height?: number;
+    r_frame_rate?: string;
+    avg_frame_rate?: string;
+    bit_rate?: number | string;
+    channels?: number;
+    sample_rate?: number | string;
+    tags?: Record<string, string | number>;
+    [key: string]: unknown;
+};
+export type FfprobeData = {
+    streams: FfprobeStream[];
+    format: {
+        duration?: number;
+        size?: number | string;
+        bit_rate?: number | string;
+        tags?: Record<string, string | number>;
+        [key: string]: unknown;
+    };
+};
 /**
  * Structural types for exceljs objects.
  * Defined here so the optional exceljs package is not required at typecheck time.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.55.9",
+  "version": "9.55.10",
   "packageManager": "pnpm@10.15.1",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
@@ -230,14 +230,11 @@
     "croner": "^9.1.0",
     "csv-parser": "^3.2.0",
     "dotenv": "^17.3.1",
-    "fluent-ffmpeg": "^2.1.3",
     "google-auth-library": "^10.6.1",
     "hono": "^4.12.3",
     "inquirer": "^13.3.0",
     "jose": "^6.1.3",
     "json-schema-to-zod": "^2.7.0",
-    "mediabunny": "^1.40.1",
-    "music-metadata": "^11.11.2",
     "nanoid": "^5.1.5",
     "ollama-ai-provider": "^1.2.0",
     "open": "^11.0.0",
@@ -271,6 +268,9 @@
     "@picovoice/cobra-node": "^3.0.2",
     "bullmq": "^5.52.2",
     "exceljs": "^4.4.0",
+    "fluent-ffmpeg": "^2.1.3",
+    "mediabunny": "^1.40.1",
+    "music-metadata": "^11.11.2",
     "mammoth": "^1.11.0",
     "pptxgenjs": "^4.0.1",
     "pdf-parse": "^2.4.5",