الأسئلة الشائعة
هل تحتاج الحزمة إلى better-auth كاعتمادية؟
لا. هي تقرأ فقط كائن error الذي يعطيك إياه عميل Better Auth (أو APIError مرمياً). وbetter-auth اعتمادية تطوير تُستخدم لتوليد قائمة الرموز.
لماذا تطابق الرموز لا الرسائل الإنجليزية؟
قد تعيد Better Auth صياغة رسائلها الإنجليزية في أي إصدار، لكن الرموز هي العقد الثابت. المطابقة بالرمز تعني أن تغيّر الصياغة في المصدر لا يمكن أن يكسر ترجماتك.
أستخدم مكتبة إشعارات أخرى
استخدم translate() من better-auth-tarjim/translate ومرّر النص إلى مكتبتك. هذا المدخل بلا اعتمادية على Sonner. راجع الوصفة.
يظهر الإشعار من اليسار إلى اليمين
تأكد من ضبط dir="rtl" على <Toaster /> أو على عنصر <html>. راجع البدء السريع.
هل تعمل مع Next.js وعلى الخادم؟
الدوال authToast وwithAuthToast وcreateAuthToast تعرض إشعاراً، فاستدعِها من مكوّنات العميل. أما translate فلا تعتمد على المتصفح، وتعمل في مكوّنات الخادم وإجراءات الخادم ومسارات الواجهة البرمجية.
ماذا يحدث عندما تضيف Better Auth رمز خطأ جديداً؟
يعرض الرمز الجديد الرسالة العربية الاحتياطية العامة إلى أن تصدر ترجمته. يفتح مسار عمل يومي طلب دمج بالرموز الجديدة، ويفشل TypeScript حتى يحصل كل رمز على رسالة عربية. وفي الأثناء يمكنك ترجمته بنفسك عبر overrides.
كيف أترجم أخطاء إضافة Better Auth الخاصة بي؟
مرّرها في overrides مفهرسة برمز الخطأ. واستخدم createAuthToast لضبطها مرة واحدة للتطبيق كله.
ما حجمها؟
نحو 7 كيلوبايت بعد الضغط (gzip) إجمالاً، وأغلبها القاموس العربي. ولا توجد اعتماديات وقت التشغيل. ويُفحص الحجم في CI مقابل حدّ ثابت.
هل يمكن عرض رسالة الخادم الإنجليزية للرموز غير المعروفة؟
نعم: translate(error, { showOriginal: true }). أما رسائل استجابات 429 و5xx فلا يحلّ نص الخادم محلّها أبداً.
هل هي حزمة رسمية من Better Auth؟
لا. هي مشروع مجتمعي مستقل وغير تابع لـ Better Auth.
هل ستُدعَم لغات أخرى؟
الحزمة عربية أولاً اليوم. الاسم والبنية محايدان لغوياً، ويمكن إضافة خيار للّغة دون كسر الواجهة الحالية. راجع البنية التقنية.
كيف أحسّن رسالة عربية؟
عدّل السطر في src/ar.ts وافتح طلب دمج. يتضمن دليل المساهمة دليلاً لأسلوب الصياغة العربية.