إشعارات أخطاء عربية لـ Better Auth

🌍

مكتوبة للمستخدمين الحقيقيين

رسائل بالعربية الفصحى المبسّطة لكل رمز خطأ في Better Auth، بصياغة تشبه ما تقوله التطبيقات فعلاً، وليست ترجمة حرفية.

🔄

متزامنة دائماً

قائمة الرموز تُولَّد من Better Auth نفسها. وعندما يضيف إصدار جديد رموزاً، يفتح مسار عمل يومي طلب دمج (Pull Request)، ويفشل TypeScript حتى تُترجَم كل الرموز.

⚡

سطر واحد للاستخدام

استدعِ authToast(error) في تدفقك الحالي، أو غلّف الاستدعاء بـ withAuthToast() لتتخلص من كتابة if.

📦

صغيرة ومحدَّدة الأنواع

نحو 7 كيلوبايت بعد الضغط (gzip) ودون أي اعتماديات وقت التشغيل. ErrorCode اتحاد (union) لكل رموز Better Auth، لذا تفشل الأخطاء الإملائية عند التجميع.

🧩

مصمَّمة لـ shadcn/ui

تستخدم الإشعارات مكتبة Sonner، مكوّن الإشعارات في shadcn/ui. ومدخل /translate بلا اعتمادية على Sonner ويعمل مع أي مكتبة إشعارات.

🛡️

آمنة افتراضياً

بحث آمن في القاموس، وكشف متحفّظ لأخطاء الشبكة، ولا تُعرض تفاصيل الخادم الداخلية للمستخدم أبداً.

شاهدها تعمل

تُرجِع Better Auth رمز خطأ ثابتاً. تبحث better-auth-tarjim عنه وتعرض الرسالة العربية في إشعار Sonner، بالاتجاه من اليمين إلى اليسار.

البريد الإلكتروني أو كلمة المرور غير صحيحة

error.code === "INVALID_EMAIL_OR_PASSWORD"

يرجى تأكيد بريدك الإلكتروني أولاً

error.code === "EMAIL_NOT_VERIFIED"

هذا الحساب موجود مسبقاً

error.code === "USER_ALREADY_EXISTS"

انتهت الجلسة، أعد تسجيل الدخول للمتابعة

error.code === "SESSION_EXPIRED"

بداية سريعة

bash

npm i better-auth-tarjim

tsx

import { authToast } from "better-auth-tarjim";

const { error } = await authClient.signIn.email({ email, password });
if (error) authToast(error); // البريد الإلكتروني أو كلمة المرور غير صحيحة

أضف مكوّن <Toaster dir="rtl" /> من Sonner مرة واحدة في التخطيط الجذري. يشرح دليل البدء السريع الإعداد الكامل، ويغطي الاستخدام الدالة withAuthToast والرسائل المخصّصة والمدخل الخالي من Sonner.

لماذا الرموز لا النصوص؟

تُبقي Better Auth رموز الأخطاء ثابتة، بينما قد تتغير رسائلها الإنجليزية بين الإصدارات. تعتمد هذه الحزمة على الرموز فقط، لذلك لا يمكن لتغيير صياغة في Better Auth أن يكسر رسائلك العربية. وعندما تضيف Better Auth رمزاً جديداً، يتغير النوع ErrorCode المُولَّد، فيخبرك البناء بدقة أي ترجمة ناقصة.

حزمة غير رسمية

better-auth-tarjim مشروع مجتمعي. وهو غير تابع لـ Better Auth، ومنشور برخصة MIT.

better-auth-tarjimرسائل أخطاء عربية لـ Better Auth