🗂️ refactor: Migrate S3 Storage to TypeScript in packages/api (#11947)

* Migrate S3 storage module with unit and integration tests

  - Migrate S3 CRUD and image operations to packages/api/src/storage/s3/
  - Add S3ImageService class with dependency injection
  - Add unit tests using aws-sdk-client-mock
  - Add integration tests with real s3 bucket (condition presence of  AWS_TEST_BUCKET_NAME)

* AI Review Findings Fixes

* chore: tests and refactor S3 storage types

- Added mock implementations for the 'sharp' library in various test files to improve image processing testing.
- Updated type references in S3 storage files from MongoFile to TFile for consistency and type safety.
- Refactored S3 CRUD operations to ensure proper handling of file types and improve code clarity.
- Enhanced integration tests to validate S3 file operations and error handling more effectively.

* chore: rename test file

* Remove duplicate import of refreshS3Url

* chore: imports order

* fix: remove duplicate imports for S3 URL handling in UserController

* fix: remove duplicate import of refreshS3FileUrls in files.js

* test: Add mock implementations for 'sharp' and '@librechat/api' in UserController tests

- Introduced mock functions for the 'sharp' library to facilitate image processing tests, including metadata retrieval and buffer conversion.
- Enhanced mocking for '@librechat/api' to ensure consistent behavior in tests, particularly for the needsRefresh and getNewS3URL functions.

---------

Co-authored-by: Danny Avila <danny@librechat.ai>

api/test/server/services/Files/S3/crud.test.js

@@ -1,72 +0,0 @@
-const { getS3URL } = require('../../../../../server/services/Files/S3/crud');
-
-// Mock AWS SDK
-jest.mock('@aws-sdk/client-s3', () => ({
-  S3Client: jest.fn(() => ({
-    send: jest.fn(),
-  })),
-  GetObjectCommand: jest.fn(),
-}));
-
-jest.mock('@aws-sdk/s3-request-presigner', () => ({
-  getSignedUrl: jest.fn(),
-}));
-
-jest.mock('../../../../../config', () => ({
-  logger: {
-    error: jest.fn(),
-  },
-}));
-
-const { getSignedUrl } = require('@aws-sdk/s3-request-presigner');
-const { GetObjectCommand } = require('@aws-sdk/client-s3');
-
-describe('S3 crud.js - test only new parameter changes', () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-    process.env.AWS_BUCKET_NAME = 'test-bucket';
-  });
-
-  // Test only the new customFilename parameter
-  it('should include customFilename in response headers when provided', async () => {
-    getSignedUrl.mockResolvedValue('https://test-presigned-url.com');
-
-    await getS3URL({
-      userId: 'user123',
-      fileName: 'test.pdf',
-      customFilename: 'cleaned_filename.pdf',
-    });
-
-    // Verify the new ResponseContentDisposition parameter is added to GetObjectCommand
-    const commandArgs = GetObjectCommand.mock.calls[0][0];
-    expect(commandArgs.ResponseContentDisposition).toBe(
-      'attachment; filename="cleaned_filename.pdf"',
-    );
-  });
-
-  // Test only the new contentType parameter
-  it('should include contentType in response headers when provided', async () => {
-    getSignedUrl.mockResolvedValue('https://test-presigned-url.com');
-
-    await getS3URL({
-      userId: 'user123',
-      fileName: 'test.pdf',
-      contentType: 'application/pdf',
-    });
-
-    // Verify the new ResponseContentType parameter is added to GetObjectCommand
-    const commandArgs = GetObjectCommand.mock.calls[0][0];
-    expect(commandArgs.ResponseContentType).toBe('application/pdf');
-  });
-
-  it('should work without new parameters (backward compatibility)', async () => {
-    getSignedUrl.mockResolvedValue('https://test-presigned-url.com');
-
-    const result = await getS3URL({
-      userId: 'user123',
-      fileName: 'test.pdf',
-    });
-
-    expect(result).toBe('https://test-presigned-url.com');
-  });
-});