@juspay/neurolink 9.5.2 → 9.6.0

package/dist/processors/media/ffprobe-static.d.ts

@@ -0,0 +1,4 @@
+declare module "ffprobe-static" {
+  const ffprobeStatic: { path: string };
+  export default ffprobeStatic;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * Media Processors Module
+ *
+ * Barrel export for media file processors (video, audio).
+ * Provides processors for extracting AI-consumable content from multimedia files.
+ *
+ * @module processors/media
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   videoProcessor,
+ *   isVideoFile,
+ *   processVideo,
+ *   type ProcessedVideo,
+ * } from "./media/index.js";
+ *
+ * if (isVideoFile(file.mimetype, file.name)) {
+ *   const result = await processVideo(fileInfo);
+ *   if (result.success) {
+ *     console.log(result.data.textContent);
+ *   }
+ * }
+ * ```
+ */
+export type { ProcessedVideo } from "./VideoProcessor.js";
+export { isVideoFile, processVideo, VideoProcessor, videoProcessor, } from "./VideoProcessor.js";

package/dist/processors/media/index.js

@@ -0,0 +1,36 @@
+/**
+ * Media Processors Module
+ *
+ * Barrel export for media file processors (video, audio).
+ * Provides processors for extracting AI-consumable content from multimedia files.
+ *
+ * @module processors/media
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   videoProcessor,
+ *   isVideoFile,
+ *   processVideo,
+ *   type ProcessedVideo,
+ * } from "./media/index.js";
+ *
+ * if (isVideoFile(file.mimetype, file.name)) {
+ *   const result = await processVideo(fileInfo);
+ *   if (result.success) {
+ *     console.log(result.data.textContent);
+ *   }
+ * }
+ * ```
+ */
+export { isVideoFile, processVideo, VideoProcessor, videoProcessor, } from "./VideoProcessor.js";
+// =============================================================================
+// AUDIO PROCESSOR (placeholder for future implementation)
+// =============================================================================
+// export {
+//   AudioProcessor,
+//   audioProcessor,
+//   isAudioFile,
+//   processAudio,
+// } from "./AudioProcessor.js";
+// export type { ProcessedAudio } from "./AudioProcessor.js";

package/dist/processors/registry/ProcessorRegistry.d.ts

@@ -4,6 +4,11 @@
  * Central registry for file processors with priority-based selection.
  * Uses singleton pattern to ensure a single source of truth for processor registration.
  *
+ * All 16 BaseFileProcessor-based processors are auto-registered on first access
+ * via getProcessorRegistry(). Legacy processors (CSV, Image, PDF, PPTX) that use
+ * static methods and don't extend BaseFileProcessor are excluded — they continue
+ * to be routed via the switch/case in FileDetector.processFile().
+ *
  * Key features:
  * - Priority-based processor selection (lower number = higher priority)
  * - Confidence scoring for match quality
@@ -17,7 +22,7 @@
  * ```typescript
  * import { ProcessorRegistry, getProcessorRegistry, PROCESSOR_PRIORITIES } from "./registry/index.js";
  *
- * const registry = getProcessorRegistry();
+ * const registry = await getProcessorRegistry();
  *
  * // Register a processor
  * registry.register({
@@ -319,16 +324,25 @@ export declare class ProcessorRegistry {
 }
 /**
  * Get the ProcessorRegistry singleton instance.
+ * On first call, auto-initializes with all 16 default processors.
  * Convenience function for shorter imports.
  *
- * @returns The ProcessorRegistry singleton
+ * @returns The ProcessorRegistry singleton (auto-initialized with default processors)
  *
  * @example
  * ```typescript
  * import { getProcessorRegistry } from "./registry/index.js";
  *
- * const registry = getProcessorRegistry();
- * registry.register(myProcessor);
+ * const registry = await getProcessorRegistry();
+ * const match = registry.findProcessor("image/svg+xml", "icon.svg");
  * ```
  */
-export declare const getProcessorRegistry: () => ProcessorRegistry;
+export declare const getProcessorRegistry: () => Promise<ProcessorRegistry>;
+/**
+ * Get the ProcessorRegistry singleton instance synchronously (without auto-initialization).
+ * Use this when you know the registry is already initialized, or when you only
+ * need the raw registry instance (e.g., for manual registration in tests).
+ *
+ * @returns The ProcessorRegistry singleton (may be empty if not yet initialized)
+ */
+export declare const getProcessorRegistrySync: () => ProcessorRegistry;

package/dist/processors/registry/ProcessorRegistry.js

@@ -4,6 +4,11 @@
  * Central registry for file processors with priority-based selection.
  * Uses singleton pattern to ensure a single source of truth for processor registration.
  *
+ * All 16 BaseFileProcessor-based processors are auto-registered on first access
+ * via getProcessorRegistry(). Legacy processors (CSV, Image, PDF, PPTX) that use
+ * static methods and don't extend BaseFileProcessor are excluded — they continue
+ * to be routed via the switch/case in FileDetector.processFile().
+ *
  * Key features:
  * - Priority-based processor selection (lower number = higher priority)
  * - Confidence scoring for match quality
@@ -17,7 +22,7 @@
  * ```typescript
  * import { ProcessorRegistry, getProcessorRegistry, PROCESSOR_PRIORITIES } from "./registry/index.js";
  *
- * const registry = getProcessorRegistry();
+ * const registry = await getProcessorRegistry();
  *
  * // Register a processor
  * registry.register({
@@ -566,13 +571,13 @@ export class ProcessorRegistry {
             return "Convert ICO files to PNG format before uploading.";
         }
         if ([".zip", ".rar", ".7z", ".tar", ".gz"].includes(ext)) {
-            return "Extract files from the archive and upload individual files.";
+            return "Archive files are now supported. NeuroLink will list contents and extract metadata.";
         }
         if ([".mp4", ".avi", ".mov", ".mkv", ".wmv"].includes(ext)) {
-            return "Video files are not supported. For video transcripts, use a transcription service first.";
+            return "Video files are now supported. NeuroLink will extract metadata and keyframes.";
         }
         if ([".mp3", ".wav", ".aac", ".ogg", ".flac"].includes(ext)) {
-            return "Audio files are not supported. For audio transcripts, use a transcription service first.";
+            return "Audio files are now supported. NeuroLink will extract metadata and tags.";
         }
         if ([".psd", ".ai", ".sketch"].includes(ext)) {
             return "Export design files to PNG, PDF, or SVG format before uploading.";
@@ -589,20 +594,110 @@ export class ProcessorRegistry {
     }
 }
 // =============================================================================
+// DEFAULT PROCESSOR REGISTRATION
+// =============================================================================
+/**
+ * Register all 16 BaseFileProcessor-based processors with the registry.
+ *
+ * Legacy processors (CSV, Image, PDF, PPTX) that use static methods and don't
+ * extend BaseFileProcessor are excluded — they continue to be routed via the
+ * switch/case in FileDetector.processFile().
+ *
+ * Uses dynamic imports to avoid circular dependencies and enable tree-shaking.
+ * Each processor is registered with its priority from PROCESSOR_PRIORITIES,
+ * and uses the processor's own isFileSupported() method for detection.
+ *
+ * @param registry - The ProcessorRegistry instance to register processors into
+ */
+async function initializeDefaultProcessors(registry) {
+    // Import all processor singletons via barrel exports
+    // Use dynamic import to avoid circular dependency issues
+    const [markup, code, data, document, media, archive, priorities] = await Promise.all([
+        import("../markup/index.js"),
+        import("../code/index.js"),
+        import("../data/index.js"),
+        import("../document/index.js"),
+        import("../media/AudioProcessor.js"),
+        import("../archive/ArchiveProcessor.js"),
+        import("../base/types.js"),
+    ]);
+    // Also import video separately (same pattern as audio)
+    const video = await import("../media/VideoProcessor.js");
+    const { PROCESSOR_PRIORITIES: P } = priorities;
+    // Registration helper — wraps register() with allowDuplicates to be idempotent
+    const reg = (name, priority, processor, description, aliases) => {
+        registry.register({
+            name,
+            priority,
+            processor,
+            isSupported: (mimetype, filename) => processor.isFileSupported(mimetype, filename),
+            description,
+            aliases,
+        }, { allowDuplicates: true });
+    };
+    // ── Markup processors ────────────────────────────────────────────────────
+    reg("svg", P.SVG, markup.svgProcessor, "SVG vector graphics (processed as text, not image)", ["svgz"]);
+    reg("html", P.HTML, markup.htmlProcessor, "HTML web content with OWASP-compliant sanitization", ["htm", "xhtml"]);
+    reg("markdown", P.MARKDOWN, markup.markdownProcessor, "Markdown structured text", ["md", "mdx"]);
+    reg("text", P.TEXT, markup.textProcessor, "Plain text files", ["txt", "log"]);
+    // ── Code processors ──────────────────────────────────────────────────────
+    reg("source_code", P.SOURCE_CODE, code.sourceCodeProcessor, "Source code files (50+ languages)", ["ts", "js", "py", "java", "go", "rs", "cpp"]);
+    reg("config", P.CONFIG, code.configProcessor, "Configuration files (.env, .ini, .toml, .cfg)", ["env", "ini", "toml", "cfg"]);
+    // ── Data processors ──────────────────────────────────────────────────────
+    reg("json", P.JSON, data.jsonProcessor, "JSON data files", ["json", "jsonl", "geojson"]);
+    reg("yaml", P.YAML, data.yamlProcessor, "YAML configuration and data files", ["yaml", "yml"]);
+    reg("xml", P.XML, data.xmlProcessor, "XML data files", ["xml", "xsd", "xsl"]);
+    // ── Document processors ──────────────────────────────────────────────────
+    reg("excel", P.EXCEL, document.excelProcessor, "Excel spreadsheets with sheet extraction", ["xlsx", "xls"]);
+    reg("word", P.WORD, document.wordProcessor, "Word documents with text extraction", ["docx"]);
+    reg("rtf", P.RTF, document.rtfProcessor, "RTF documents", ["rtf"]);
+    reg("opendocument", P.OPENDOCUMENT, document.openDocumentProcessor, "OpenDocument format files", ["odt", "ods", "odp"]);
+    // ── Media processors ─────────────────────────────────────────────────────
+    reg("audio", P.AUDIO, media.audioProcessor, "Audio files with metadata and tag extraction", ["mp3", "wav", "ogg", "flac", "aac", "m4a", "wma"]);
+    reg("video", P.VIDEO, video.videoProcessor, "Video files with metadata and keyframe extraction", ["mp4", "mkv", "webm", "avi", "mov", "m4v"]);
+    // ── Archive processors ───────────────────────────────────────────────────
+    reg("archive", P.ARCHIVE, archive.archiveProcessor, "Archive files with content listing", ["zip", "tar", "gz", "tgz"]);
+    registry.markInitialized();
+}
+// =============================================================================
 // CONVENIENCE EXPORT
 // =============================================================================
+/** Promise tracking the ongoing initialization (prevents double-init races) */
+let initPromise = null;
 /**
  * Get the ProcessorRegistry singleton instance.
+ * On first call, auto-initializes with all 16 default processors.
  * Convenience function for shorter imports.
  *
- * @returns The ProcessorRegistry singleton
+ * @returns The ProcessorRegistry singleton (auto-initialized with default processors)
  *
  * @example
  * ```typescript
  * import { getProcessorRegistry } from "./registry/index.js";
  *
- * const registry = getProcessorRegistry();
- * registry.register(myProcessor);
+ * const registry = await getProcessorRegistry();
+ * const match = registry.findProcessor("image/svg+xml", "icon.svg");
  * ```
  */
-export const getProcessorRegistry = () => ProcessorRegistry.getInstance();
+export const getProcessorRegistry = async () => {
+    const registry = ProcessorRegistry.getInstance();
+    if (!registry.isInitialized()) {
+        if (!initPromise) {
+            initPromise = initializeDefaultProcessors(registry).catch((err) => {
+                // Reset so next call retries
+                initPromise = null;
+                throw err;
+            });
+        }
+        await initPromise;
+    }
+    return registry;
+};
+/**
+ * Get the ProcessorRegistry singleton instance synchronously (without auto-initialization).
+ * Use this when you know the registry is already initialized, or when you only
+ * need the raw registry instance (e.g., for manual registration in tests).
+ *
+ * @returns The ProcessorRegistry singleton (may be empty if not yet initialized)
+ */
+export const getProcessorRegistrySync = () => ProcessorRegistry.getInstance();

package/dist/processors/registry/index.d.ts

@@ -9,4 +9,4 @@
 export type { ProcessorMatch, ProcessorPriorityKey, ProcessorPriorityValue, RegistryOptions, RegistryProcessResult, UnsupportedFileError, } from "../base/types.js";
 export type { ProcessorRegistration } from "./types.js";
 export { PROCESSOR_PRIORITIES } from "../base/types.js";
-export { getProcessorRegistry, ProcessorRegistry, } from "./ProcessorRegistry.js";
+export { getProcessorRegistry, getProcessorRegistrySync, ProcessorRegistry, } from "./ProcessorRegistry.js";

package/dist/processors/registry/index.js

@@ -13,4 +13,4 @@ export { PROCESSOR_PRIORITIES } from "../base/types.js";
 // =============================================================================
 // CLASS EXPORTS
 // =============================================================================
-export { getProcessorRegistry, ProcessorRegistry, } from "./ProcessorRegistry.js";
+export { getProcessorRegistry, getProcessorRegistrySync, ProcessorRegistry, } from "./ProcessorRegistry.js";

package/dist/processors/registry/types.d.ts

@@ -28,7 +28,7 @@ import type { ProcessedFileBase } from "../base/types.js";
  * };
  * ```
  */
-export interface ProcessorRegistration<T extends ProcessedFileBase = ProcessedFileBase> {
+export type ProcessorRegistration<T extends ProcessedFileBase = ProcessedFileBase> = {
     /** Unique name for the processor */
     name: string;
     /**
@@ -50,4 +50,4 @@ export interface ProcessorRegistration<T extends ProcessedFileBase = ProcessedFi
     description?: string;
     /** Alternative names that can be used to look up this processor */
     aliases?: string[];
-}
+};

package/dist/providers/googleAiStudio.d.ts

@@ -74,6 +74,40 @@ export declare class GoogleAIStudioProvider extends BaseProvider {
      * Override generate to route Gemini 3 models with tools to native SDK
      */
     generate(optionsOrPrompt: TextGenerationOptions | string): Promise<EnhancedGenerateResult | null>;
+    /**
+     * Convert Vercel AI SDK tools to @google/genai FunctionDeclarations and an execute map.
+     * Shared by executeNativeGemini3Stream and executeNativeGemini3Generate.
+     */
+    private buildNativeToolDeclarations;
+    /**
+     * Build the native @google/genai config object shared by stream and generate.
+     */
+    private buildNativeConfig;
+    /**
+     * Compute a safe, clamped maxSteps value.
+     */
+    private computeMaxSteps;
+    /**
+     * Process stream chunks to extract raw response parts, function calls, and usage metadata.
+     * Shared by executeNativeGemini3Stream and executeNativeGemini3Generate.
+     */
+    private collectStreamChunks;
+    /**
+     * Extract text from raw response parts. Used after collectStreamChunks.
+     */
+    private extractTextFromParts;
+    /**
+     * Execute a batch of function calls with retry tracking and permanent failure detection.
+     * Shared by executeNativeGemini3Stream and executeNativeGemini3Generate.
+     *
+     * Returns function responses for history and optional tool execution records for generate.
+     */
+    private executeNativeToolCalls;
+    /**
+     * Handle maxSteps termination by producing a final text when the model
+     * was still calling tools when the step limit was reached.
+     */
+    private handleMaxStepsTermination;
     private executeAudioStreamViaGeminiLive;
     private getApiKey;
 }