سجل تغييرات الحزمة
إصدارات @smsfabric/sdk على npm. تتبع الحزمة الترقيم الدلالي: الإصدار الفرعي يضيف دوال، والإصدار الرئيسي قد يغيرها أو يحذفها.
1.1.0 (2026-11-19)
Section titled “1.1.0 (2026-11-19)”الإضافات
Section titled “الإضافات”- تصدير الدالتين
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): قاعدة إعادة المحاولة في العميل.
الإصلاحات
Section titled “الإصلاحات”- يستخدم العميل
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تعامل كأنها غير مضبوطة.
تغييرات في السلوك
Section titled “تغييرات في السلوك”- ترتيب بيانات الاعتماد:
apiKeyالذي تمرره، ثمaccessTokenالذي تمرره، ثمSMSFABRIC_API_KEY. - لا تعاد محاولة
409إلا معidempotency_in_progress. - قد ينجح طلب
DELETEالمعاد عند تلقي404. - المحتوى الموقّع الذي لا يمكن تحليله يرمي
SignatureVerificationError.
1.0.0 (2026-11-19)
Section titled “1.0.0 (2026-11-19)”أول إصدار عام على 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 مع ملفات الأنواع، دون اعتماديات وقت التشغيل.