Feat: #553 [SEP-12] Verify File Existence Using Metadata Head Requests

[Olamidepy]

Description

Resolved #553 . This PR implements a new StorageProvider service to support [SEP-12] KYC file verification using S3 metadata query requests (HEAD requests) rather than downloading the file content.

Changes

• S3 Integration: Installed @aws-sdk/client-s3.
• StorageProvider Service: Added storage.provider.ts with objectExists() utilizing HeadObjectCommand. It returns false (handling it gracefully) upon catching NotFound or NoSuchKey S3 errors.
• Unit Tests: Created storage.provider.test.ts covering success, expected S3 errors (graceful checks), connection failure, and edge cases with 100% test coverage.

Verification

• Checked that TypeScript compiles cleanly: npm run build
• Ran and passed unit tests: npm test src/services/storage.provider.test.ts
• Verified ESLint rules are fully respected: npm run lint

[drips-wave]

@Olamidepy Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[Olamidepy]

@Ceejaytech25 kindly merge