👁️ feat: Azure Mistral OCR Strategy (#7888)

* 👁️ feat: Add Azure Mistral OCR strategy and endpoint integration

This commit introduces a new OCR strategy named 'azure_mistral_ocr', allowing the use of a Mistral OCR endpoint deployed on Azure. The configuration, schemas, and file upload strategies have been updated to support this integration, enabling seamless OCR processing via Azure-hosted Mistral services.

* 🗑️ chore: Clean up .gitignore by removing commented-out uncommon directory name

* chore: remove unused vars

* refactor: Move createAxiosInstance to packages/api/utils and update imports

- Removed the createAxiosInstance function from the config module and relocated it to a new utils module for better organization.
- Updated import paths in relevant files to reflect the new location of createAxiosInstance.
- Added tests for createAxiosInstance to ensure proper functionality and proxy configuration handling.

* chore: move axios helpers to packages/api

- Added logAxiosError function to @librechat/api for centralized error logging.
- Updated imports across various files to use the new logAxiosError function.
- Removed the old axios.js utility file as it is no longer needed.

* chore: Update Jest moduleNameMapper for improved path resolution

- Added a new mapping for '~/' to resolve module paths in Jest configuration, enhancing import handling for the project.

* feat: Implement Mistral OCR API integration in TS

* chore: Update MistralOCR tests based on new imports

* fix: Enhance MistralOCR configuration handling and tests

- Introduced helper functions for resolving configuration values from environment variables or hardcoded settings.
- Updated the uploadMistralOCR and uploadAzureMistralOCR functions to utilize the new configuration resolution logic.
- Improved test cases to ensure correct behavior when mixing environment variables and hardcoded values.
- Mocked file upload and signed URL responses in tests to validate functionality without external dependencies.

* feat: Enhance MistralOCR functionality with improved configuration and error handling

- Introduced helper functions for loading authentication configuration and resolving values from environment variables.
- Updated uploadMistralOCR and uploadAzureMistralOCR functions to utilize the new configuration logic.
- Added utility functions for processing OCR results and creating error messages.
- Improved document type determination and result aggregation for better OCR processing.

* refactor: Reorganize OCR type imports in Mistral CRUD file

- Moved OCRResult, OCRResultPage, and OCRImage imports to a more logical grouping for better readability and maintainability.

* feat: Add file exports to API and create files index

* chore: Update OCR types for enhanced structure and clarity

- Redesigned OCRImage interface to include mandatory fields and improved naming conventions.
- Added PageDimensions interface for better representation of page metrics.
- Updated OCRResultPage to include dimensions and mandatory images array.
- Refined OCRResult to include document annotation and usage information.

* refactor: use TS counterpart of uploadOCR methods

* ci: Update MistralOCR tests to reflect new OCR result structure

* chore: Bump version of @librechat/api to 1.2.3 in package.json and package-lock.json

* chore: Update CONFIG_VERSION to 1.2.8

* chore: remove unused sendEvent function from config module (now imported from '@librechat/api')

* chore: remove MistralOCR service files and tests (now in '@librechat/api')

* ci: update logger import in ModelService tests to use @librechat/data-schemas

---------

Co-authored-by: arthurolivierfortin <arthurolivier.fortin@gmail.com>

api/utils/axios.js

@@ -1,46 +0,0 @@
-const { logger } = require('~/config');
-
-/**
- * Logs Axios errors based on the error object and a custom message.
- *
- * @param {Object} options - The options object.
- * @param {string} options.message - The custom message to be logged.
- * @param {import('axios').AxiosError} options.error - The Axios error object.
- * @returns {string} The log message.
- */
-const logAxiosError = ({ message, error }) => {
-  let logMessage = message;
-  try {
-    const stack = error.stack || 'No stack trace available';
-
-    if (error.response?.status) {
-      const { status, headers, data } = error.response;
-      logMessage = `${message} The server responded with status ${status}: ${error.message}`;
-      logger.error(logMessage, {
-        status,
-        headers,
-        data,
-        stack,
-      });
-    } else if (error.request) {
-      const { method, url } = error.config || {};
-      logMessage = `${message} No response received for ${method ? method.toUpperCase() : ''} ${url || ''}: ${error.message}`;
-      logger.error(logMessage, {
-        requestInfo: { method, url },
-        stack,
-      });
-    } else if (error?.message?.includes("Cannot read properties of undefined (reading 'status')")) {
-      logMessage = `${message} It appears the request timed out or was unsuccessful: ${error.message}`;
-      logger.error(logMessage, { stack });
-    } else {
-      logMessage = `${message} An error occurred while setting up the request: ${error.message}`;
-      logger.error(logMessage, { stack });
-    }
-  } catch (err) {
-    logMessage = `Error in logAxiosError: ${err.message}`;
-    logger.error(logMessage, { stack: err.stack || 'No stack trace available' });
-  }
-  return logMessage;
-};
-
-module.exports = { logAxiosError };

api/utils/index.js

@@ -1,5 +1,4 @@
 const loadYaml = require('./loadYaml');
-const axiosHelpers = require('./axios');
 const tokenHelpers = require('./tokens');
 const deriveBaseURL = require('./deriveBaseURL');
 const extractBaseURL = require('./extractBaseURL');
@@ -9,7 +8,6 @@ module.exports = {
   loadYaml,
   deriveBaseURL,
   extractBaseURL,
-  ...axiosHelpers,
   ...tokenHelpers,
   findMessageContent,
 };