blaaiz-nodejs-sdk 1.1.0 → 1.1.2

package/README.md

@@ -94,6 +94,23 @@ const customers = await blaaiz.customers.list();
 console.log('Customers:', customers.data);
 ```
 
+You can also pass optional filters and opt-in pagination. Supported filters
+are `email`, `id_number`, `registration_number`, `verification_status`, and
+`type`. Set `paginate: true` to receive a paginated response that includes
+`links` and `meta` (with `current_page`, `total`, etc.) alongside `data`.
+
+```javascript
+const verified = await blaaiz.customers.list({
+  email: 'john@example.com',
+  verification_status: 'VERIFIED',
+  type: 'individual',
+  paginate: true
+});
+
+console.log('Page:', verified.data.meta.current_page);
+console.log('Customers:', verified.data.data);
+```
+
 #### Update Customer
 
 ```javascript
@@ -128,7 +145,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

@@ -35,7 +35,43 @@ export interface CustomerData {
 export interface Customer extends CustomerData {
   id: string;
   business_id: string;
-  verification_status: 'PENDING' | 'VERIFIED' | 'REJECTED';
+  verification_status: 'PENDING' | 'PROCESSING' | 'VERIFIED' | 'REJECTED';
+}
+
+export interface CustomerListFilters {
+  email?: string;
+  id_number?: string;
+  registration_number?: string;
+  verification_status?: 'PENDING' | 'PROCESSING' | 'VERIFIED' | 'REJECTED';
+  type?: 'individual' | 'business';
+  paginate?: boolean;
+  page?: number;
+  per_page?: number;
+  [key: string]: string | number | boolean | undefined;
+}
+
+export interface PaginationLinks {
+  first?: string | null;
+  last?: string | null;
+  prev?: string | null;
+  next?: string | null;
+}
+
+export interface PaginationMeta {
+  current_page: number;
+  from?: number | null;
+  last_page?: number;
+  path?: string;
+  per_page?: number;
+  to?: number | null;
+  total: number;
+}
+
+export interface PaginatedCustomers {
+  data: Customer[];
+  links: PaginationLinks;
+  meta: PaginationMeta;
+  message?: string;
 }
 
 export interface CustomerKYCData {
@@ -52,6 +88,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;
 }
 
@@ -242,7 +280,7 @@ export interface WebhookEvent {
 export declare class CustomerService {
   constructor(client: any);
   create(customerData: CustomerData): Promise<BlaaizResponse<{ data: Customer }>>;
-  list(): Promise<BlaaizResponse<Customer[]>>;
+  list(filters?: CustomerListFilters): Promise<BlaaizResponse<Customer[] | PaginatedCustomers>>;
   get(customerId: string): Promise<BlaaizResponse<Customer>>;
   update(customerId: string, updateData: Partial<CustomerData>): Promise<BlaaizResponse<Customer>>;
   addKYC(customerId: string, kycData: CustomerKYCData): Promise<BlaaizResponse<any>>;
@@ -331,7 +369,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.2",
   "description": "Official Node.js SDK for Blaaiz RaaS (Remittance as a Service) API",
   "main": "index.js",
   "types": "index.d.ts",
@@ -40,10 +40,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/blaaiz/nodejs-sdk.git"
+    "url": "git+https://github.com/Blaaiz/blaaiz-nodejs-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/blaaiz/nodejs-sdk/issues"
+    "url": "https://github.com/Blaaiz/blaaiz-nodejs-sdk/issues"
   },
   "homepage": "https://docs.business.blaaiz.com",
   "engines": {

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

@@ -25,8 +25,15 @@ class CustomerService {
     return this.client.makeRequest('POST', '/api/external/customer', customerData)
   }
 
-  async list () {
-    return this.client.makeRequest('GET', '/api/external/customer')
+  async list (filters = {}) {
+    const params = new URLSearchParams()
+    for (const [key, value] of Object.entries(filters || {})) {
+      if (value === undefined || value === null) continue
+      params.append(key, typeof value === 'boolean' ? String(value) : value)
+    }
+    const query = params.toString()
+    const endpoint = query ? `/api/external/customer?${query}` : '/api/external/customer'
+    return this.client.makeRequest('GET', endpoint)
   }
 
   async get (customerId) {
@@ -84,7 +91,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 +137,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 +171,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 +187,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 +392,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',