إكمال المصادقة والعملاء لـ Edge Functions عبر supabase/server

Install

npx skills add supabase/server

لمن يناسب

تناسب هذه المهارة من يكتب Edge Functions أو واجهات API ولا يريد إعادة كتابة المصادقة وإنشاء العميل ومعالجة CORS يدويًا مرارًا. رسميًا هي غلاف جانب الخادم: تتولى المصادقة وإنشاء العميل وحقن السياق، وأنت تكتب منطق العمل. تناسب أيضًا من يستخدم أصلًا وكيل ترميز بالذكاء الاصطناعي — يقول النص الأصلي إنه يمكن تثبيت المهارة في وكلاء مثل Claude Code و Cursor.

لا تناسب من يصنع صفحات متصفح فقط ولا يلمس مدخل خادم أبدًا. يجب أن يدخل الطلب Edge Functions أو API حتى يُحدَّد إنشاء العميل والمصادقة تلقائيًا بنطاق الطلب الوارد. إن لم يتوفر بعد وكيل يمكنه تثبيت المهارات، أكّد أنك تستطيع تشغيل أمر التثبيت الرسمي قبل المتابعة. يكفي أيضًا تحقق للقراءة فقط: اطلب من الوكيل شرح كيفية تغليف fetch بسطر إعداد واحد، ولا تغيّر دوال الإنتاج فورًا. المستودع الرسمي هو

https://github.com/supabase/server

اتبع الأوامر المكتوبة أصلًا في تلك الصفحة.

أكمل أول محاولة في 3 دقائق

اسلك فقط مسار تثبيت المهارة الواحد الذي يكتبه النص الرسمي.

الشرط المسبق: يستطيع هذا الجهاز تشغيل npx، وتستخدم أحد وكلاء الترميز بالذكاء الاصطناعي المذكورين في النص، مثل Claude Code أو Cursor. يكفي فتح المشروع الذي تكتب فيه عادةً Edge Functions أو واجهات API. هذه الخطوة تحقق شرح؛ لا تغيّر الشفرة الحية ولا ترسل طلبات للخارج.

موضع التثبيت: في طرفية عند جذر المشروع نفّذ:

npx skills add supabase/server

يثبّت هذا الأمر المهارة في الوكيل الحالي. يقول النص الرسمي أيضًا: في Deno أو Supabase Edge Functions يمكنك عدم تثبيت حزمة والاستيراد مباشرة من npm:@supabase/server.

أطلق مهمة منخفضة المخاطر: اطلب من الوكيل الذي ثبّت المهارة أن يسرد نصًا «كيف تغلف fetch بـ withSupabase بحيث لا تدخل دالة المعالجة إلا بعد نجاح المصادقة»، وأن يكتب جملة الاستيراد. لا تكتب ملفات ولا تستدعِ واجهات خارجية ولا تنشر.

إشارة النجاح: يستطيع الوكيل إعادة أن بعد استيراد واحد وسطر إعداد تُتحقق المصادقة ويصبح العميل جاهزًا ويُعالَج CORS ولا تعمل دالة المعالجة إلا بعد نجاح المصادقة؛ ويعطي import { withSupabase } from "npm:@supabase/server". إن اخترع أمر تثبيت آخر فارجع إلى الأمر الرسمي أعلاه وأعد المحاولة.

حالات الاستخدام

الحالة الأولى: إضافة الغلاف الرسمي إلى مدخل fetch لدالة Edge Function أو API قائمة. المسار الرئيسي في النص هو تغليف fetch بـ withSupabase: بعد استيراد واحد وسطر إعداد تُتحقق المصادقة ويصبح العميل جاهزًا ويُعالَج CORS ولا تعمل دالة المعالجة إلا عند نجاح المصادقة. يمكنك أولاً أن تطلب من الوكيل تعليم المدخل الذي يجب تغييره وشفرة العمل التي تبقى كما هي، ثم تتصرف بعد التأكيد. إن لم يكن في النص مثال دالة كامل فتوقف عند «غُلف المدخل ولن تدخل المصادقة الفاشلة دالة المعالجة»؛ لا تخترع جدول مسارات ولا مخطط أسرار.

الحالة الثانية: الاستيراد مباشرة في Deno أو Supabase Edge Functions بدل تثبيت حزمة أولاً. يقول النص إن تلك البيئة يمكنها تخطي التثبيت واستخدام import { withSupabase } from "npm:@supabase/server" مباشرة. يناسب من يكتب أصلًا دوال معالجة في بيئة التشغيل تلك ويريد فقط التحقق من مسار الاستيراد. أكّد أولاً أن الاستيراد ينطبق على بيئة تشغيل الملف الحالي؛ إن لم يكن المشروع Deno أو Edge Functions يتوقف النص هنا — لا توسّعه إلى بيئة تشغيل غير مسمّاة.

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

يغطي النص مدخل الخادم فقط: يُحدَّد إنشاء العميل والمصادقة تلقائيًا بالطلبات الواردة التي تدخل Edge Functions و APIs. لا يثبت الاستخدام على صفحات المتصفح أو مهام الخلفية المجدولة أو بيئات استضافة غير مسمّاة.

أمر تثبيت المهارة المكتوب واحد فقط: npx skills add supabase/server. لا تضع مثبّتًا لم يظهر في المسار الرئيسي. تسمية Claude Code و Cursor وغيرهما مجموعة أمثلة، لا الوكيلين الوحيدين المدعومين.

في جانب استخدام الحزمة يعطي النص الاستيراد المباشر لـ Deno / Supabase Edge Functions وتغليف fetch بـ withSupabase. إن لم ترَ أسماء متغيرات بيئة أو مفاتيح CORS تفصيلية أو سياسة إعادة المحاولة فلا تُكملها. تعمل دالة المعالجة فقط بعد نجاح المصادقة؛ أي رمز حالة يُعاد عند الفشل غير مكتوب. الصفحة الرسمية هي