مكتبة SMS4jawaly لـ Angular

مكتبة Angular للتعامل مع خدمة 4jawaly SMS API. تتيح هذه المكتبة إرسال الرسائل القصيرة واستعلام معلومات الحساب بسهولة.

التثبيت

npm install sms4jawaly

الاستخدام

1. قم بإضافة HttpClientModule إلى imports في الموديول الرئيسي:

import { HttpClientModule } from '@angular/common/http';

@NgModule({
  imports: [
    HttpClientModule
  ]
})

2. قم باستيراد واستخدام الخدمة في المكون الخاص بك:

import { Sms4jawalyService } from 'sms4jawaly';

@Component({
  // ...
})
export class YourComponent {
  constructor(private sms4jawaly: Sms4jawalyService) {
    // تهيئة الخدمة بمفاتيح API الخاصة بك
    this.sms4jawaly.initialize('your-api-key', 'your-api-secret');
  }

  // مثال على إرسال رسالة
  sendMessage() {
    this.sms4jawaly.sendSMS(
      'مرحباً بكم!',
      ['966500000000'],
      'SENDER_NAME'
    ).subscribe(
      response => console.log('تم إرسال الرسالة بنجاح', response),
      error => console.error('حدث خطأ', error)
    );
  }

  // مثال على استعلام الرصيد
  checkBalance() {
    this.sms4jawaly.getBalance().subscribe(
      balance => console.log('الرصيد الحالي', balance),
      error => console.error('حدث خطأ', error)
    );
  }
}

## الوظائف المتاحة

1. `initialize(apiKey: string, apiSecret: string)`: تهيئة الخدمة بمفاتيح API
2. `sendSMS(message: string, numbers: string[], sender: string)`: إرسال رسائل SMS
3. `getBalance()`: استعلام عن رصيد الحساب
4. `getSenders()`: الحصول على قائمة أسماء المرسلين

## المساهمة

نرحب بمساهماتكم! يرجى إرسال pull request أو فتح issue لأي اقتراحات أو تحسينات.

## الترخيص

MIT