blaaiz-nodejs-sdk 1.1.0 → 1.1.1

package/README.md

@@ -128,7 +128,7 @@ const result = await blaaiz.customers.uploadFileComplete('customer-id', {
   file: fileBuffer, // Buffer or Uint8Array
   file_category: 'identity', // identity, proof_of_address, liveness_check
   filename: 'passport.jpg', // Optional
-  contentType: 'image/jpeg' // Optional
+  content_type: 'image/jpeg' // Optional
 });
 
 // Option B: Upload from Base64 string

package/index.d.ts

@@ -52,6 +52,8 @@ export interface FileUploadOptions {
   file: Buffer | Uint8Array | string;
   file_category: 'identity' | 'proof_of_address' | 'liveness_check';
   filename?: string;
+  content_type?: string;
+  /** @deprecated Use content_type instead */
   contentType?: string;
 }
 
@@ -331,7 +333,7 @@ export declare class Blaaiz {
   
   testConnection(): Promise<boolean>;
   
-  createCompleteePayout(payoutConfig: {
+  createCompletePayout(payoutConfig: {
     customerData?: CustomerData;
     payoutData: PayoutData;
   }): Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blaaiz-nodejs-sdk",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Official Node.js SDK for Blaaiz RaaS (Remittance as a Service) API",
   "main": "index.js",
   "types": "index.d.ts",

package/src/index.js

@@ -39,7 +39,7 @@ class Blaaiz {
     }
   }
 
-  async createCompleteePayout (payoutConfig) {
+  async createCompletePayout (payoutConfig) {
     const { customerData, payoutData } = payoutConfig
 
     try {

package/src/services/CustomerService.js

@@ -84,7 +84,8 @@ class CustomerService {
     }
 
     const { file, file_category } = fileOptions // eslint-disable-line camelcase
-    let { filename, contentType } = fileOptions
+    let { filename } = fileOptions
+    let contentType = fileOptions.content_type || fileOptions.contentType // eslint-disable-line camelcase
 
     if (!file) {
       throw new Error('File is required')
@@ -129,6 +130,15 @@ class CustomerService {
         if (file.startsWith('data:')) {
           // Handle data URL format: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAABAAEDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAv/xAAUEAEAAAAAAAAAAAAAAAAAAAAA/8QAFQEBAQAAAAAAAAAAAAAAAAAAAAX/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwCdABmX/9k=
           const base64Data = file.split(',')[1]
+          if (!base64Data || !base64Data.trim()) {
+            throw new Error('Invalid data URL: no base64 data found after the comma')
+          }
+          if (!/^[A-Za-z0-9+/]*={0,2}$/.test(base64Data.trim())) {
+            throw new Error(
+              'The base64 portion of the data URL does not appear to be valid base64. ' +
+              'Ensure the string after the comma contains only valid base64 characters.'
+            )
+          }
           fileBuffer = Buffer.from(base64Data, 'base64')
 
           // Extract content type from data URL if not provided
@@ -154,6 +164,15 @@ class CustomerService {
           }
         } else {
           // Handle plain base64 string
+          if (!file.trim()) {
+            throw new Error('The file string is empty')
+          }
+          if (!/^[A-Za-z0-9+/]*={0,2}$/.test(file.trim())) {
+            throw new Error(
+              'The file string does not appear to be valid base64. ' +
+              'If you meant to pass a file path, Buffer, or URL, use the appropriate format instead.'
+            )
+          }
           fileBuffer = Buffer.from(file, 'base64')
         }
       } else {
@@ -161,6 +180,19 @@ class CustomerService {
         fileBuffer = Buffer.from(file)
       }
 
+      // Auto-detect content type if not provided
+      if (!contentType) {
+        contentType = this._detectContentTypeFromBytes(fileBuffer)
+      }
+      if (!contentType && filename) {
+        contentType = this._getContentTypeFromFilename(filename)
+      }
+      if (!contentType) {
+        throw new Error(
+          'Could not determine file content type. Please provide a content_type (e.g., "image/jpeg", "image/png", "application/pdf") in fileOptions.'
+        )
+      }
+
       await this._uploadToS3(presignedUrl, fileBuffer, contentType, filename)
 
       // Map file category to the correct field name expected by Laravel API
@@ -353,6 +385,66 @@ class CustomerService {
     })
   }
 
+  _detectContentTypeFromBytes (buffer) {
+    if (!buffer || buffer.length < 4) return null
+
+    // JPEG: FF D8 FF
+    if (buffer[0] === 0xFF && buffer[1] === 0xD8 && buffer[2] === 0xFF) {
+      return 'image/jpeg'
+    }
+    // PNG: 89 50 4E 47
+    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4E && buffer[3] === 0x47) {
+      return 'image/png'
+    }
+    // GIF: 47 49 46 38
+    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x38) {
+      return 'image/gif'
+    }
+    // PDF: 25 50 44 46 (%PDF)
+    if (buffer[0] === 0x25 && buffer[1] === 0x50 && buffer[2] === 0x44 && buffer[3] === 0x46) {
+      return 'application/pdf'
+    }
+    // WEBP: starts with RIFF....WEBP
+    if (buffer.length >= 12 &&
+        buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46 &&
+        buffer[8] === 0x57 && buffer[9] === 0x45 && buffer[10] === 0x42 && buffer[11] === 0x50) {
+      return 'image/webp'
+    }
+    // BMP: 42 4D
+    if (buffer[0] === 0x42 && buffer[1] === 0x4D) {
+      return 'image/bmp'
+    }
+    // TIFF: 49 49 2A 00 (little-endian) or 4D 4D 00 2A (big-endian)
+    if ((buffer[0] === 0x49 && buffer[1] === 0x49 && buffer[2] === 0x2A && buffer[3] === 0x00) ||
+        (buffer[0] === 0x4D && buffer[1] === 0x4D && buffer[2] === 0x00 && buffer[3] === 0x2A)) {
+      return 'image/tiff'
+    }
+
+    return null
+  }
+
+  _getContentTypeFromFilename (filename) {
+    if (!filename) return null
+
+    const ext = filename.toLowerCase().split('.').pop()
+    const extToMime = {
+      jpg: 'image/jpeg',
+      jpeg: 'image/jpeg',
+      png: 'image/png',
+      gif: 'image/gif',
+      webp: 'image/webp',
+      bmp: 'image/bmp',
+      tiff: 'image/tiff',
+      tif: 'image/tiff',
+      pdf: 'application/pdf',
+      txt: 'text/plain',
+      doc: 'application/msword',
+      docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+    }
+
+    return extToMime[ext] || null
+  }
+
   _getExtensionFromContentType (contentType) {
     const mimeToExt = {
       'image/jpeg': '.jpg',