@frenchbaas/js

SDK JavaScript officiel pour FrenchBaas — le BaaS français.

Installation

npm install @frenchbaas/js

Démarrage rapide

import { FrenchBaas } from '@frenchbaas/js'

const client = new FrenchBaas({
  url:    'https://app.frenchbaas.com',
  apiKey: 'votre-clé-api',
})

Auth

// Inscription
const { user } = await client.auth.signUp({ email: '[email protected]', password: 'secret' })

// Connexion
const { user } = await client.auth.login({ email: '[email protected]', password: 'secret' })

// Déconnexion
await client.auth.logout()

// État
client.auth.getUser()     // { id, email } | null
client.auth.isLoggedIn()  // boolean

Collections (documents)

const col = client.collection('collection-uuid')

// Lire (paginé)
const { data, meta } = await col.get({ page: 1, perPage: 20 })

// Créer
const doc = await col.create({ title: 'Hello', published: true })

// Mettre à jour
const doc = await col.update('doc-id', { title: 'Modifié' })

// Supprimer
await col.delete('doc-id')

// Schéma de la collection
const schema = await col.schema()

Gestion des erreurs

import {
  AuthError,
  ValidationError,
  NotFoundError,
  QuotaError,
  RateLimitError,
  NetworkError,
  ServerError,
} from '@frenchbaas/js'

try {
  await client.collection('col-id').create({ title: 'Test' })
} catch (e) {
  if (e instanceof AuthError)       console.error('Non connecté ou session expirée')
  if (e instanceof ValidationError) console.error('Données invalides', e.errors)
  if (e instanceof NotFoundError)   console.error('Introuvable')
  if (e instanceof QuotaError)      console.error('Quota dépassé')
  if (e instanceof RateLimitError)  console.error('Trop de requêtes, réessayez dans quelques instants')
  if (e instanceof NetworkError)    console.error('Hors ligne')
  if (e instanceof ServerError)     console.error('Erreur interne du serveur')
}

Options

// Persister la session dans localStorage (rechargement de page)
const client = new FrenchBaas({
  url:     'https://app.frenchbaas.com',
  apiKey:  'votre-clé-api',
  storage: 'localStorage', // défaut : 'memory'
})

Fonctionnalités automatiques

• Refresh token transparent — access token rafraîchi automatiquement avant expiration
• Retry sur 401 — relance la requête après refresh sans intervention du développeur
• Déduplication — plusieurs requêtes simultanées ne déclenchent qu'un seul refresh
• Erreurs typées — chaque erreur HTTP a sa classe TypeScript dédiée
• Zero dépendance — aucune dépendance runtime
• TypeScript — types inclus

License

MIT

frenchbaas-js