Compléter auth et clients des Edge Functions avec supabase/server

Install

npx skills add supabase/server

À qui ça s'adresse

Ce skill convient à qui écrit des Edge Functions ou des API et ne veut pas réécrire à la main l'auth, la création de client et le CORS. Officiellement c'est une enveloppe côté serveur : auth, création de client et injection de contexte sont gérés, vous écrivez la logique métier. Il convient aussi à qui utilise déjà un agent de code IA — le texte source dit qu'on peut installer le skill dans des agents tels que Claude Code et Cursor.

Il ne convient pas à qui ne fait que des pages navigateur et ne touche jamais une entrée serveur. La requête doit entrer dans des Edge Functions ou une API pour que création de client et auth soient automatiquement bornées à la requête entrante. S'il n'y a pas encore d'agent capable d'installer des skills, confirmez que vous pouvez exécuter la commande d'installation officielle avant de continuer. Une vérification en lecture seule suffit aussi : demander à l'agent d'expliquer comment envelopper fetch avec une ligne de configuration, sans changer tout de suite les fonctions de production. Le dépôt officiel est

https://github.com/supabase/server

Suivez les commandes déjà écrites sur cette page.

Premier essai en 3 minutes

Ne prenez que le seul chemin d'installation de skill écrit officiellement.

Prérequis : cette machine peut exécuter npx, et vous utilisez l'un des agents de code IA nommés dans le texte, par exemple Claude Code ou Cursor. Ouvrir le projet où vous écrivez d'habitude des Edge Functions ou des API suffit. Cette étape est une vérification d'explication ; ne changez pas le code en ligne et n'envoyez pas de requêtes sortantes.

Emplacement d'installation : dans un terminal à la racine du projet, exécutez :

npx skills add supabase/server

Cette commande installe le skill dans l'agent courant. Le texte officiel dit aussi : dans Deno ou les Supabase Edge Functions, vous pouvez ne pas installer de paquet et importer directement depuis npm:@supabase/server.

Déclencher une tâche à bas risque : demander à l'agent qui a le skill de lister en texte « comment envelopper fetch avec withSupabase pour que la fonction de traitement ne s'exécute qu'après succès de l'auth », et d'écrire l'instruction d'import. Ne pas écrire de fichiers, appeler d'interfaces externes, ni déployer.

Signal de succès : l'agent peut reformuler qu'après un import et une ligne de configuration, l'auth est vérifiée, le client est prêt, le CORS est traité, et la fonction de traitement ne s'exécute qu'après succès de l'auth ; et il donne import { withSupabase } from "npm:@supabase/server". S'il invente une autre commande d'installation, revenir à la commande officielle ci-dessus et réessayer.

Cas d'usage

Cas 1 : ajouter l'enveloppe officielle à l'entrée fetch d'une Edge Function ou d'une API existante. Le chemin principal du texte est d'envelopper fetch avec withSupabase : après un import et une ligne de configuration, l'auth est vérifiée, le client est prêt, le CORS est traité, et la fonction de traitement ne s'exécute que si l'auth réussit. Vous pouvez d'abord demander à l'agent de marquer l'entrée à changer et le code métier à laisser tel quel, puis agir après confirmation. S'il n'y a pas d'exemple de fonction complet, s'arrêter à « l'entrée est enveloppée, un échec d'auth n'entre pas dans la fonction de traitement » ; n'inventez pas de table de routes ni de schéma de secrets.

Cas 2 : importer directement dans Deno ou les Supabase Edge Functions au lieu d'installer un paquet d'abord. Le texte dit que cet environnement peut sauter l'installation et utiliser directement import { withSupabase } from "npm:@supabase/server". Cela convient à qui écrit déjà des fonctions de traitement dans ce runtime et veut seulement vérifier le chemin d'import. Confirmez d'abord que l'import s'applique au runtime du fichier courant ; si le projet n'est ni Deno ni Edge Functions, le texte s'arrête ici — ne l'étendez pas à un runtime non nommé.

Limites d'usage

Le texte ne couvre que l'entrée serveur : création de client et auth sont automatiquement bornées aux requêtes entrantes qui entrent dans les Edge Functions et APIs. Il ne prouve pas l'usage sur des pages navigateur, des tâches planifiées d'arrière-plan ou des hébergements non nommés.

Une seule commande d'installation de skill est écrite : npx skills add supabase/server. Ne mettez pas un installeur absent sur le chemin principal. Claude Code, Cursor et d'autres forment un ensemble d'exemples, pas les seuls deux agents pris en charge.

Côté usage du paquet, le texte donne l'import direct pour Deno / Supabase Edge Functions et l'enveloppe de fetch avec withSupabase. Si vous ne voyez pas de noms de variables d'environnement, d'interrupteurs CORS détaillés ou de stratégie de nouvel essai, n'en ajoutez pas. La fonction de traitement ne s'exécute qu'après succès de l'auth ; quel code d'état est renvoyé en cas d'échec n'est pas écrit. La page officielle est