@juspay/neurolink 8.20.1 → 8.21.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.21.0](https://github.com/juspay/neurolink/compare/v8.20.1...v8.21.0) (2025-12-22)
+
+### Features
+
+- **(types):** Add office document type definitions and comprehensive tests ([1b34d3d](https://github.com/juspay/neurolink/commit/1b34d3de8114bdc56600cc785e7e52aa1af1ddc7))
+
 ## [8.20.1](https://github.com/juspay/neurolink/compare/v8.20.0...v8.20.1) (2025-12-22)
 
 ### Bug Fixes

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

@@ -4,7 +4,11 @@
 /**
  * Supported file types for multimodal input
  */
-export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "unknown";
+export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "docx" | "pptx" | "xlsx" | "unknown";
+/**
+ * Office document types
+ */
+export type OfficeDocumentType = "docx" | "pptx" | "xlsx";
 /**
  * File input can be Buffer or string (path/URL/data URI)
  */
@@ -47,6 +51,16 @@ export type FileProcessingResult = {
         estimatedPages?: number | null;
         provider?: string;
         apiType?: PDFAPIType;
+        officeFormat?: OfficeDocumentType;
+        pageCount?: number;
+        slideCount?: number;
+        sheetCount?: number;
+        sheetNames?: string[];
+        author?: string;
+        createdDate?: string;
+        modifiedDate?: string;
+        hasFormulas?: boolean;
+        hasImages?: boolean;
     };
 };
 /**
@@ -152,6 +166,50 @@ export type AudioProcessorOptions = {
     /** Maximum file size in megabytes */
     maxSizeMB?: number;
 };
+/**
+ * Office processor options for Word, PowerPoint, and Excel documents
+ *
+ * @example Word document processing (docx)
+ * ```typescript
+ * const options: OfficeProcessorOptions = {
+ *   format: "docx",
+ *   extractTextOnly: false,
+ *   includeMetadata: true
+ * };
+ * ```
+ *
+ * @example PowerPoint processing (pptx)
+ * ```typescript
+ * const options: OfficeProcessorOptions = {
+ *   format: "pptx",
+ *   includeSlideNotes: true,  // pptx-specific
+ *   includeMetadata: true
+ * };
+ * ```
+ *
+ * @example Excel processing (xlsx)
+ * ```typescript
+ * const options: OfficeProcessorOptions = {
+ *   format: "xlsx",
+ *   processAllSheets: true,   // xlsx-specific
+ *   includeMetadata: true
+ * };
+ * ```
+ */
+export type OfficeProcessorOptions = {
+    /** Office document format type */
+    format?: OfficeDocumentType;
+    /** Whether to extract text only (true) or preserve formatting (false). Applies to: docx, pptx, xlsx */
+    extractTextOnly?: boolean;
+    /** Maximum file size in megabytes. Applies to: docx, pptx, xlsx */
+    maxSizeMB?: number;
+    /** Whether to include metadata (author, created date, etc.). Applies to: docx, pptx, xlsx */
+    includeMetadata?: boolean;
+    /** For spreadsheets (xlsx only): whether to process all sheets or just the first */
+    processAllSheets?: boolean;
+    /** For presentations (pptx only): whether to include slide notes */
+    includeSlideNotes?: boolean;
+};
 /**
  * File detector options
  */
@@ -161,6 +219,7 @@ export type FileDetectorOptions = {
     allowedTypes?: FileType[];
     audioOptions?: AudioProcessorOptions;
     csvOptions?: CSVProcessorOptions;
+    officeOptions?: OfficeProcessorOptions;
     confidenceThreshold?: number;
     provider?: string;
 };

package/dist/types/fileTypes.d.ts

@@ -4,7 +4,11 @@
 /**
  * Supported file types for multimodal input
  */
-export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "unknown";
+export type FileType = "csv" | "image" | "pdf" | "audio" | "text" | "docx" | "pptx" | "xlsx" | "unknown";
+/**
+ * Office document types
+ */
+export type OfficeDocumentType = "docx" | "pptx" | "xlsx";
 /**
  * File input can be Buffer or string (path/URL/data URI)
  */
@@ -47,6 +51,16 @@ export type FileProcessingResult = {
         estimatedPages?: number | null;
         provider?: string;
         apiType?: PDFAPIType;
+        officeFormat?: OfficeDocumentType;
+        pageCount?: number;
+        slideCount?: number;
+        sheetCount?: number;
+        sheetNames?: string[];
+        author?: string;
+        createdDate?: string;
+        modifiedDate?: string;
+        hasFormulas?: boolean;
+        hasImages?: boolean;
     };
 };
 /**
@@ -152,6 +166,50 @@ export type AudioProcessorOptions = {
     /** Maximum file size in megabytes */
     maxSizeMB?: number;
 };
+/**
+ * Office processor options for Word, PowerPoint, and Excel documents
+ *
+ * @example Word document processing (docx)
+ * ```typescript
+ * const options: OfficeProcessorOptions = {
+ *   format: "docx",
+ *   extractTextOnly: false,
+ *   includeMetadata: true
+ * };
+ * ```
+ *
+ * @example PowerPoint processing (pptx)
+ * ```typescript
+ * const options: OfficeProcessorOptions = {
+ *   format: "pptx",
+ *   includeSlideNotes: true,  // pptx-specific
+ *   includeMetadata: true
+ * };
+ * ```
+ *
+ * @example Excel processing (xlsx)
+ * ```typescript
+ * const options: OfficeProcessorOptions = {
+ *   format: "xlsx",
+ *   processAllSheets: true,   // xlsx-specific
+ *   includeMetadata: true
+ * };
+ * ```
+ */
+export type OfficeProcessorOptions = {
+    /** Office document format type */
+    format?: OfficeDocumentType;
+    /** Whether to extract text only (true) or preserve formatting (false). Applies to: docx, pptx, xlsx */
+    extractTextOnly?: boolean;
+    /** Maximum file size in megabytes. Applies to: docx, pptx, xlsx */
+    maxSizeMB?: number;
+    /** Whether to include metadata (author, created date, etc.). Applies to: docx, pptx, xlsx */
+    includeMetadata?: boolean;
+    /** For spreadsheets (xlsx only): whether to process all sheets or just the first */
+    processAllSheets?: boolean;
+    /** For presentations (pptx only): whether to include slide notes */
+    includeSlideNotes?: boolean;
+};
 /**
  * File detector options
  */
@@ -161,6 +219,7 @@ export type FileDetectorOptions = {
     allowedTypes?: FileType[];
     audioOptions?: AudioProcessorOptions;
     csvOptions?: CSVProcessorOptions;
+    officeOptions?: OfficeProcessorOptions;
     confidenceThreshold?: number;
     provider?: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.20.1",
+  "version": "8.21.0",
   "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 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",