@aurabase/aurabase-js 0.3.0 → 0.4.0

package/packages/auth/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Aurabase
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/packages/auth/README.md

@@ -1,215 +0,0 @@
-# @aurabase/auth
-
-Service d'authentification du SDK Aurabase : mots de passe, sessions, OAuth/PKCE, magic link, OTP, MFA et administration des utilisateurs.
-
-![npm](https://img.shields.io/npm/v/@aurabase/auth) ![license](https://img.shields.io/badge/license-MIT-blue)
-
-> Pre-release — pas encore publié sur npm.
-
-Fait partie du SDK **[aurabase](../aurabase)**. Installé automatiquement avec `aurabase` ; ce package est publié séparément pour un usage ciblé / tree-shaking.
-
-## Installation
-
-```bash
-npm i @aurabase/auth
-```
-
-> Ce package dépend de `@aurabase/core` (`workspace:*` en interne, résolu en semver côté npm). Si vous utilisez déjà le package `aurabase`, `@aurabase/auth` est déjà inclus — cette installation ciblée n'est utile que pour composer votre propre client ou limiter la taille du bundle.
-
-## Usage
-
-Dans l'usage courant, `AuthService` n'est jamais instancié directement : il est exposé par le client principal sous `aura.auth`.
-
-```ts
-import { createClient } from 'aurabase'
-
-const aura = createClient('http://localhost:8080', 'my-project', 'aura_anon_xxx')
-```
-
-### Mot de passe
-
-```ts
-const signUp = await aura.auth.signUp({ email: 'user@example.com', password: 'correct horse battery staple' })
-
-const signIn = await aura.auth.signInWithPassword({ email: 'user@example.com', password: 'correct horse battery staple' })
-
-await aura.auth.signOut()
-```
-
-### Session
-
-```ts
-// getSession() n'est PAS un AuraResponse : il lit directement le store local (synchrone en pratique).
-const { accessToken, user } = await aura.auth.getSession()
-
-const refreshed = await aura.auth.refreshSession()
-
-// Injecter une session existante (ex. tokens restaurés depuis un stockage sécurisé) : valide l'access token côté serveur.
-await aura.auth.setSession('stored-access-token', 'stored-refresh-token')
-
-const sessions = await aura.auth.listSessions()
-await aura.auth.revokeSession(sessions.data![0].id)
-await aura.auth.revokeAllSessions()
-```
-
-### OAuth (implicite ou PKCE)
-
-`signInWithOAuth` ne redirige plus « en dur » : il renvoie toujours `{ url }` (et redirige en plus via `window.location.href` si un `window` existe).
-
-```ts
-const { data, error } = await aura.auth.signInWithOAuth('github', {
-  redirectTo: 'http://localhost:3000/auth/callback',
-  scopes: 'read:user user:email',
-  flowType: 'pkce', // opt-in ; nécessite un store persistant (LocalAuthStore) côté navigateur
-})
-
-if (error) throw error
-
-// Côté serveur / SSR : pas de redirection automatique, il faut rediriger manuellement vers data!.url
-console.log(data!.url)
-```
-
-Retour du provider (flux PKCE) :
-
-```ts
-const session = await aura.auth.exchangeCodeForSession('auth-code-from-callback')
-
-// Mobile natif : échange d'un ID token provider (Google/Apple) contre une session Aurabase
-await aura.auth.signInWithIdToken('google', 'id-token-from-provider')
-```
-
-### Magic link / OTP
-
-```ts
-await aura.auth.signInWithMagicLink({ email: 'user@example.com', redirect_url: 'http://localhost:3000/auth/callback' })
-await aura.auth.verifyMagicLink('token-from-link')
-
-await aura.auth.signInWithEmailOtp('user@example.com')
-await aura.auth.verifyEmailOtp('user@example.com', '123456')
-
-await aura.auth.signInWithSmsOtp('+15551234567')
-await aura.auth.verifySmsOtp('+15551234567', '123456')
-```
-
-### Anonyme
-
-```ts
-await aura.auth.signInAnonymously()
-
-// Convertit la session anonyme courante en compte email+password.
-await aura.auth.promoteAnonymous({ email: 'user@example.com', password: 'correct horse battery staple' })
-```
-
-### Utilisateur, claims, mot de passe
-
-```ts
-const { data: user } = await aura.auth.getUser()
-
-// Vérification locale JWKS (RS256/ES256) avec fallback getUser() (HS256 / JWKS vide).
-const { data: claims } = await aura.auth.getClaims()
-
-await aura.auth.updateUser({ data: { display_name: 'Ada' } })
-
-// Révoque toutes les sessions et déconnecte le client après le changement.
-await aura.auth.updatePassword('new-password', 'current-password')
-
-await aura.auth.deleteUser('current-password')
-```
-
-### Réinitialisation de mot de passe
-
-```ts
-await aura.auth.resetPasswordForEmail({ email: 'user@example.com' })
-await aura.auth.resetPassword('token-from-email', 'new-password')
-```
-
-Le lien envoyé par email pointe vers `{site}/reset-password?token=<opaque>&project_id=<uuid>&type=recovery`.
-Quand l'utilisateur ouvre ce lien, `detectSessionInUrl` (activé par défaut en navigateur) le
-détecte au boot et émet l'événement `PASSWORD_RECOVERY` sur `onAuthStateChange`, en exposant le
-token opaque via `recoveryToken` — **sans** ouvrir de session et **sans** émettre `SIGNED_IN`
-(l'utilisateur n'est authentifié qu'après avoir choisi un nouveau mot de passe). L'app affiche
-alors son formulaire « nouveau mot de passe » puis rappelle `resetPassword` :
-
-```ts
-aura.auth.onAuthStateChange(({ event, recoveryToken }) => {
-  if (event === 'PASSWORD_RECOVERY' && recoveryToken) {
-    // Affiche le formulaire, récupère le nouveau mot de passe, puis :
-    await aura.auth.resetPassword(recoveryToken, 'new-password')
-  }
-})
-```
-
-Les paramètres (`token`, `project_id`, `type`) sont ensuite retirés de l'URL (best-effort,
-via `history.replaceState`).
-
-### Vérification d'email
-
-```ts
-await aura.auth.verifyEmail('token-from-email')
-await aura.auth.resendVerificationEmail() // reprend l'email de la session courante si omis
-await aura.auth.confirmEmailChange('token-from-email')
-```
-
-### MFA (TOTP)
-
-```ts
-const enrollment = await aura.auth.mfaEnroll() // { otpauth_url, secret }
-await aura.auth.mfaVerifySetup('123456')
-
-await aura.auth.mfaVerify({ mfa_token: 'mfa-token-from-login-response', code: '123456' })
-
-await aura.auth.regenerateRecoveryCodes('123456')
-await aura.auth.mfaUnenroll('current-password')
-```
-
-### Configuration publique
-
-```ts
-const settings = await aura.auth.getSettings()
-const anonKey = await aura.auth.getAnonKey()
-```
-
-### État d'authentification
-
-```ts
-const subscription = aura.auth.onAuthStateChange(({ event, user, accessToken }) => {
-  console.log(event, user?.email)
-})
-
-subscription.unsubscribe()
-
-// Démonte le cycle de vie proactif (ticker de refresh, BroadcastChannel multi-onglets).
-aura.dispose()
-```
-
-Événements émis (valeur réelle de `AuthChangePayload.event`) : `INITIAL_SESSION`, `SIGNED_IN`, `SIGNED_OUT`, `TOKEN_REFRESHED`, `USER_UPDATED`, `MFA_CHALLENGE`, `PASSWORD_RECOVERY` (voir « Réinitialisation de mot de passe »).
-
-### Administration (`AuthAdminService`)
-
-Réservé au serveur (clé `service_role`). Deux façons d'y accéder :
-
-```ts
-// Via le client admin (recommandé)
-import { createAdminClient } from 'aurabase'
-
-const admin = createAdminClient('http://localhost:8080', 'my-project', process.env.SERVICE_ROLE_KEY!)
-await admin.authAdmin.listUsers({ limit: 50 })
-```
-
-```ts
-// Import direct du service (composition avancée)
-import { AuthAdminService } from '@aurabase/auth'
-```
-
-Méthodes clés : `listUsers`, `getUser`, `createUser`, `updateUser`, `deleteUser`, `banUser`, `unbanUser`, `generateLink`, `getUserStats`, `listUserIdentities`, `listSessions`, `revokeSession`, `getAuditLog`, `getSettings`, `updateSettings`, `listEmailTemplates`/`getEmailTemplate`/`updateEmailTemplate`/`deleteEmailTemplate`, `testEmailTemplate`.
-
-## Limitations
-
-- Pas de `resend()` / `reauthenticate()` / `verifyOtp()` unifiés (style Supabase) : chaque canal (magic link, email OTP, SMS OTP) a sa propre paire `signInWith*`/`verify*`.
-- Pas de SSO/SAML.
-- MFA limité au TOTP : pas de `listFactors()`, pas de niveau d'authentification (AAL), pas de MFA par téléphone.
-- `getClaims()` en fallback (HS256 / JWKS vide) ne renvoie pas `exp`/`iat` — ne pas s'y fier après un fallback.
-
-## Documentation
-
-Référence complète du SDK (tous les services, types partagés, SSR) : [README racine](../../README.md).