تخطَّ إلى المحتوى

سجل تغييرات الحزمة

إصدارات @smsfabric/sdk على npm. تتبع الحزمة الترقيم الدلالي: الإصدار الفرعي يضيف دوال، والإصدار الرئيسي قد يغيرها أو يحذفها.

  • تصدير الدالتين verifySignature وconstructEvent وحدهما. لم يعد مستقبل خطافات الويب يحتاج إلى عميل أو مفتاح API. راجع خطافات الويب.
  • النوع RawBody. يمكن أن يكون المحتوى الخام لخطاف الويب Uint8Array أيضًا، مثل الناتج من await request.arrayBuffer().
  • الحقلان SMSFabricError.headers وSMSFabricError.retryAfter (بالثواني، من Retry-After). راجع الأخطاء.
  • أخطاء الشبكة تحفظ الخطأ الأصلي في cause وتذكره في الرسالة، مثل fetch failed (connect ECONNREFUSED 127.0.0.1:3000).
  • الدالة isRetryable(status, code): قاعدة إعادة المحاولة في العميل.
  • يستخدم العميل accessToken الممرر حتى لو كان SMSFABRIC_API_KEY مضبوطًا. في السابق كان مفتاح البيئة هو المستخدم، فترد نقاط النهاية الخاصة بالمستخدمين بـ 403 api_key_not_allowed.
  • لا تعاد إلا محاولة 409 idempotency_in_progress. أما التعارضات مثل 409 contact_exists فترمى فورًا.
  • طلب DELETE المعاد بعد خطأ شبكة أو تجاوز مهلة أو 5xx ينجح إذا تلقى 404.
  • ترمي constructEvent الخطأ SignatureVerificationError بدل SyntaxError إذا كان المحتوى موقّعًا توقيعًا صحيحًا لكنه ليس كائن JSON.
  • القيم الفارغة لـ apiKey وaccessToken وbaseUrl وSMSFABRIC_API_KEY وSMSFABRIC_BASE_URL تعامل كأنها غير مضبوطة.
  • ترتيب بيانات الاعتماد: apiKey الذي تمرره، ثم accessToken الذي تمرره، ثم SMSFABRIC_API_KEY.
  • لا تعاد محاولة 409 إلا مع idempotency_in_progress.
  • قد ينجح طلب DELETE المعاد عند تلقي 404.
  • المحتوى الموقّع الذي لا يمكن تحليله يرمي SignatureVerificationError.

أول إصدار عام على npm.

  • الرسائل: send وlist وlistAll وget وstats وexportCsv.
  • التحقق (OTP): verifications.send وcheck وget وlist وlistAll؛ وverifications.settings.get وupdate.
  • الأجهزة والشرائح: devices.createPairingToken وlist وget وupdate وdelete وupdateSim وsetDefaultSim.
  • المجموعات: pools.list وcreate وupdate وdelete.
  • خطافات الويب: webhooks.list وcreate وupdate وdelete وdeliveries وdeliveriesAll وreplay وtest، إضافة إلى verifySignature وconstructEvent؛ وwebhooks.listen التي تنقل أحداث المؤسسة إلى جهازك أثناء التطوير (GET /v1/webhooks/listen)، وتبدل البث وتعيد الاتصال وحدها.
  • القائمة السوداء: blacklist.list وlistAll وadd وremove.
  • جهات الاتصال: contacts.* وcontacts.groups.* وcontacts.imports.* (رفع ملف CSV وبدء الاستيراد)، مع listAll لكل قائمة.
  • القوالب والحملات: templates.* (مع preview) وcampaigns.* (مع estimate وstart وpause وresume وcancel وreport).
  • المؤسسة: org.get وupdate؛ وorg.members.list وupdate وremove؛ وorg.invitations.list وcreate وrevoke.
  • الباقة: plan.get تعيد الباقة وحدودها مع الإضافات والميزات والاستخدام (GET /v1/org/plan).
  • التفضيلات: preferences.get وupdate.
  • سجل التدقيق: audit.list وlistAll.
  • مفاتيح API: apiKeys.list وcreate وrotate وrevoke.
  • إعادة المحاولة عند 429 و5xx وأخطاء الشبكة مع انتظار متزايد يحترم Retry-After؛ وIdempotency-Key مع كل عملية إنشاء. أما 429 quota_exceeded (استهلاك حصة الباقة) فيُرمى فورا ولا تعاد محاولته.
  • يحمل SMSFabricError الحقول status وcode وdetail وerrors وrequestId، والحقل params عند الرفض بسبب الباقة.
  • نسختا ESM وCommonJS مع ملفات الأنواع، دون اعتماديات وقت التشغيل.