@frenchbaas/js 0.3.1 → 0.4.1

package/README.md

@@ -119,6 +119,87 @@ Ces permissions se configurent dans le Dashboard → collection → schéma →
 
 ---
 
+## Storage
+
+```js
+// Lister les buckets du projet (X-Api-Key uniquement, pas de Bearer)
+const buckets = await client.storage.listBuckets()
+// → [{ id, name, visibility, public, created_at }, ...]
+
+// Obtenir un client bucket
+const bucket = client.storage.bucket('uuid-bucket')
+
+// Lister les fichiers (paginé, filtre préfixe optionnel)
+const { data, meta } = await bucket.listObjects({ page: 1, perPage: 20, prefix: 'users/123/' })
+// → data: [{ id, name, content_type, size, created_by, created_at, url? }, ...]
+// → meta: { total, page, per_page, pages }
+
+// Upload un fichier (3 étapes gérées automatiquement : présignature → PUT OVH → confirmation)
+// Bearer requis.
+const file = document.querySelector('input[type=file]').files[0]
+const obj = await bucket.upload(file, 'photo.jpg', {
+  onProgress: pct => console.log(`${pct}%`), // progression optionnelle (navigateur uniquement)
+})
+// → { id, name, content_type, size, created_by, created_at, url? }
+
+// Récupérer l'URL d'un fichier
+const { url, expires_in } = await bucket.getUrl(obj.id)
+// Bucket public  → url permanente, expires_in absent
+// Bucket privé   → url signée (TTL 3600 s), créateur uniquement
+
+// Supprimer un fichier (Bearer requis, créateur uniquement)
+await bucket.delete(obj.id)
+```
+
+### Bucket privé — stocker et retrouver un fichier
+
+Avec un bucket privé, l'URL signée expire après 1h. Il ne faut **pas** stocker l'URL — il faut stocker l'`id` de l'objet retourné par `upload()`, puis appeler `getUrl()` à chaque affichage.
+
+**Workflow recommandé :**
+
+```js
+// 1. Upload → récupérer l'id de l'objet
+const obj = await bucket.upload(file, 'photo.jpg')
+const objectId = obj.id // ex: "a1b2c3d4-..."
+
+// 2. Stocker l'id dans une collection FrenchBaas (pas l'URL)
+await client.collection('profils').update(userId, {
+  avatar_storage_id: objectId,
+})
+
+// 3. À l'affichage : récupérer l'id depuis la collection, puis générer l'URL
+const profil = await client.collection('profils').getById(userId)
+const storedId = profil.data.avatar_storage_id
+
+const { url } = await bucket.getUrl(storedId)
+// url → URL signée fraîche, valide 1h
+```
+
+> ⚠️ Ne stockez jamais l'URL signée — elle expire. Stockez toujours l'`id` de l'objet.
+
+### Visibilité des buckets
+
+| Visibilité | listObjects | upload / delete | getUrl |
+|------------|-------------|-----------------|--------|
+| `public` | Sans Bearer | Bearer requis | Sans Bearer (URL permanente) |
+| `private` | Bearer requis (ses fichiers) | Bearer requis | Bearer requis (URL signée 1h) |
+
+### Erreurs Storage
+
+```ts
+import { ConflictError, ValidationError, QuotaError } from '@frenchbaas/js'
+
+try {
+  await bucket.upload(file, 'photo.jpg')
+} catch (e) {
+  if (e instanceof ConflictError)   console.error('Nom déjà pris par un autre utilisateur')
+  if (e instanceof ValidationError) console.error('Fichier trop grand ou type non autorisé')
+  if (e instanceof QuotaError)      console.error('Quota storage dépassé')
+}
+```
+
+---
+
 ## Webhooks
 
 Si une collection a un `before_create_url` ou `before_update_url` configuré,
@@ -162,6 +243,7 @@ try {
 import {
   FrenchBaasError,
   AuthError,
+  ConflictError,
   ValidationError,
   NotFoundError,
   QuotaError,
@@ -180,6 +262,7 @@ try {
     console.error(e.message, e.errors)
   }
   else if (e instanceof AuthError)      console.error('Non connecté ou session expirée')
+  else if (e instanceof ConflictError)  console.error('Conflit : ressource déjà existante')
   else if (e instanceof NotFoundError)  console.error('Document ou collection introuvable')
   else if (e instanceof QuotaError)     console.error('Quota dépassé :', e.message)
   else if (e instanceof RateLimitError) console.error('Trop de requêtes, réessayez dans quelques instants')

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthError: () => AuthError,
+  ConflictError: () => ConflictError,
   FrenchBaas: () => FrenchBaasClient,
   FrenchBaasError: () => FrenchBaasError,
   NetworkError: () => NetworkError,
@@ -91,6 +92,13 @@ var ServerError = class extends FrenchBaasError {
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
+var ConflictError = class extends FrenchBaasError {
+  constructor(message = "Conflit : la ressource existe d\xE9j\xE0.") {
+    super(message, 409);
+    this.name = "ConflictError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
 
 // src/auth.ts
 var AuthModule = class {
@@ -416,6 +424,8 @@ var HttpClient = class {
         const details = err.errors ?? [];
         throw new ValidationError(details.length ? details.join(", ") : msg, details);
       }
+      case 409:
+        throw new ConflictError(msg);
       case 429:
         throw new RateLimitError();
       default:
@@ -425,6 +435,139 @@ var HttpClient = class {
   }
 };
 
+// src/storage.ts
+var StorageModule = class {
+  constructor(_http) {
+    this._http = _http;
+  }
+  /**
+   * Liste tous les buckets du projet.
+   *
+   * Authentification par API key uniquement — pas de Bearer requis.
+   * Usage principal : découverte des IDs pendant la construction de l'app.
+   */
+  async listBuckets() {
+    const res = await this._http.get(
+      "/sdk/storage/buckets"
+    );
+    return res.data;
+  }
+  /**
+   * Retourne un client pour opérer sur un bucket spécifique.
+   *
+   * @param bucketId UUID du bucket (visible dans Dashboard → Storage)
+   */
+  bucket(bucketId) {
+    if (!bucketId || typeof bucketId !== "string") {
+      throw new Error("[FrenchBaas] storage.bucket() requiert un UUID de bucket valide.");
+    }
+    return new StorageBucketClient(bucketId, this._http);
+  }
+};
+var StorageBucketClient = class {
+  constructor(_bucketId, _http) {
+    this._bucketId = _bucketId;
+    this._http = _http;
+  }
+  /**
+   * Liste les fichiers du bucket avec pagination et filtre préfixe.
+   *
+   * - Bucket **public** : Bearer non requis — retourne tous les fichiers.
+   * - Bucket **privé**  : Bearer requis — retourne uniquement les fichiers du user connecté.
+   *
+   * @example
+   * const { data, meta } = await bucket.listObjects({ prefix: 'users/123/', perPage: 20 })
+   */
+  async listObjects(options = {}) {
+    const params = {};
+    if (options.page !== void 0) params["page"] = options.page;
+    if (options.perPage !== void 0) params["per_page"] = options.perPage;
+    if (options.prefix) params["prefix"] = options.prefix;
+    return this._http.get(
+      `/sdk/storage/buckets/${this._bucketId}/objects`,
+      params
+    );
+  }
+  /**
+   * Upload un fichier en 3 étapes : présignature → PUT direct vers OVH → confirmation.
+   *
+   * Bearer requis. La progression PUT (0–100 %) peut être suivie via `options.onProgress`.
+   *
+   * @param file     Fichier ou Blob à uploader
+   * @param name     Nom dans le bucket (ex: "photo.jpg", "users/123/avatar.jpg")
+   * @param options  contentType (override), onProgress
+   *
+   * @example
+   * const obj = await bucket.upload(file, 'avatar.jpg', {
+   *   onProgress: pct => console.log(`${pct}%`)
+   * })
+   */
+  async upload(file, name, options = {}) {
+    const contentType = options.contentType ?? ((file instanceof File ? file.type : "") || "application/octet-stream");
+    const presign = await this._http.post(`/sdk/storage/buckets/${this._bucketId}/upload`, {
+      name,
+      content_type: contentType,
+      size: file.size
+    });
+    await this._putToOvh(presign.upload_url, file, contentType, options.onProgress);
+    const confirm = await this._http.post(
+      `/sdk/storage/buckets/${this._bucketId}/confirm`,
+      { name, key: presign.key, content_type: contentType }
+    );
+    return confirm.data;
+  }
+  /**
+   * Retourne l'URL d'accès à un fichier.
+   *
+   * - Bucket **public**  : URL publique permanente, Bearer non requis.
+   * - Bucket **privé**   : URL signée (TTL 3600 s), Bearer requis, créateur uniquement.
+   */
+  async getUrl(objectId) {
+    return this._http.get(
+      `/sdk/storage/buckets/${this._bucketId}/objects/${objectId}/url`
+    );
+  }
+  /**
+   * Supprime un fichier du bucket.
+   * Bearer requis. Seul le créateur du fichier peut le supprimer.
+   */
+  async delete(objectId) {
+    await this._http.delete(`/sdk/storage/buckets/${this._bucketId}/objects/${objectId}`);
+  }
+  // ── Private ──────────────────────────────────────────────────────────────
+  /**
+   * PUT direct vers l'URL présignée OVH.
+   * Utilise XHR (si disponible) pour le suivi de progression, sinon fetch.
+   */
+  async _putToOvh(url, file, contentType, onProgress) {
+    if (typeof onProgress === "function" && typeof XMLHttpRequest !== "undefined") {
+      return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open("PUT", url);
+        xhr.setRequestHeader("Content-Type", contentType);
+        xhr.upload.addEventListener("progress", (e) => {
+          if (e.lengthComputable) onProgress(Math.round(e.loaded / e.total * 100));
+        });
+        xhr.addEventListener("load", () => {
+          if (xhr.status >= 200 && xhr.status < 300) resolve();
+          else reject(new NetworkError(`Upload OVH \xE9chou\xE9 (${xhr.status})`));
+        });
+        xhr.addEventListener(
+          "error",
+          () => reject(new NetworkError("Erreur r\xE9seau lors de l'upload OVH."))
+        );
+        xhr.send(file);
+      });
+    }
+    const res = await fetch(url, {
+      method: "PUT",
+      headers: { "Content-Type": contentType },
+      body: file
+    });
+    if (!res.ok) throw new NetworkError(`Upload OVH \xE9chou\xE9 (${res.status})`);
+  }
+};
+
 // src/token.ts
 var KEYS = {
   access: "frenchbaas_access_token",
@@ -539,6 +682,7 @@ var FrenchBaasClient = class {
     this._tokenStore = new TokenStore(config.storage ?? "memory");
     this._http = new HttpClient(baseUrl, config.apiKey, this._tokenStore);
     this.auth = new AuthModule(this._http, this._tokenStore, baseUrl, config.apiKey);
+    this.storage = new StorageModule(this._http);
   }
   /**
    * Retourne un client pour une collection spécifique.
@@ -570,6 +714,7 @@ var FrenchBaasClient = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthError,
+  ConflictError,
   FrenchBaas,
   FrenchBaasError,
   NetworkError,

package/dist/index.d.mts

@@ -77,6 +77,44 @@ interface CollectionSchema {
     visibility: 'public' | 'authenticated' | 'private';
     schema: SchemaField[];
 }
+interface StorageBucket {
+    id: string;
+    name: string;
+    visibility: 'public' | 'private';
+    public: boolean;
+    created_at: string;
+}
+interface StorageObject {
+    id: string;
+    name: string;
+    content_type: string;
+    size: number;
+    created_by: string | null;
+    created_at: string;
+    /** URL publique — présente uniquement si le bucket est public */
+    url?: string;
+}
+interface StorageListOptions {
+    /** Numéro de page (défaut: 1) */
+    page?: number;
+    /** Fichiers par page — max 100 (défaut: 50) */
+    perPage?: number;
+    /** Filtre les fichiers dont le nom commence par ce préfixe */
+    prefix?: string;
+}
+interface StorageListResult {
+    data: StorageObject[];
+    meta: PaginationMeta;
+}
+interface StorageUploadOptions {
+    /** Force le Content-Type (sinon déduit de file.type) */
+    contentType?: string;
+    /**
+     * Callback appelé pendant le PUT vers OVH (0–100).
+     * Nécessite XMLHttpRequest (navigateur). Ignoré côté Node/SSR.
+     */
+    onProgress?: (pct: number) => void;
+}
 interface OpenApiSpec {
     openapi: string;
     info: Record<string, unknown>;
@@ -283,6 +321,93 @@ declare class CollectionClient<T = Record<string, unknown>> {
     schema(): Promise<CollectionSchema>;
 }
 
+/**
+ * Module storage — découverte des buckets et accès aux opérations par bucket.
+ *
+ * @example
+ * ```ts
+ * // Lister les buckets (pas de Bearer requis)
+ * const buckets = await client.storage.listBuckets()
+ *
+ * // Opérations sur un bucket spécifique
+ * const bucket = client.storage.bucket('bucket-uuid')
+ * const obj    = await bucket.upload(file, 'photo.jpg')
+ * const list   = await bucket.listObjects({ prefix: 'users/123/' })
+ * const { url } = await bucket.getUrl(obj.id)
+ * await bucket.delete(obj.id)
+ * ```
+ */
+declare class StorageModule {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /**
+     * Liste tous les buckets du projet.
+     *
+     * Authentification par API key uniquement — pas de Bearer requis.
+     * Usage principal : découverte des IDs pendant la construction de l'app.
+     */
+    listBuckets(): Promise<StorageBucket[]>;
+    /**
+     * Retourne un client pour opérer sur un bucket spécifique.
+     *
+     * @param bucketId UUID du bucket (visible dans Dashboard → Storage)
+     */
+    bucket(bucketId: string): StorageBucketClient;
+}
+/**
+ * Client pour les opérations sur un bucket spécifique.
+ */
+declare class StorageBucketClient {
+    private readonly _bucketId;
+    private readonly _http;
+    constructor(_bucketId: string, _http: HttpClient);
+    /**
+     * Liste les fichiers du bucket avec pagination et filtre préfixe.
+     *
+     * - Bucket **public** : Bearer non requis — retourne tous les fichiers.
+     * - Bucket **privé**  : Bearer requis — retourne uniquement les fichiers du user connecté.
+     *
+     * @example
+     * const { data, meta } = await bucket.listObjects({ prefix: 'users/123/', perPage: 20 })
+     */
+    listObjects(options?: StorageListOptions): Promise<StorageListResult>;
+    /**
+     * Upload un fichier en 3 étapes : présignature → PUT direct vers OVH → confirmation.
+     *
+     * Bearer requis. La progression PUT (0–100 %) peut être suivie via `options.onProgress`.
+     *
+     * @param file     Fichier ou Blob à uploader
+     * @param name     Nom dans le bucket (ex: "photo.jpg", "users/123/avatar.jpg")
+     * @param options  contentType (override), onProgress
+     *
+     * @example
+     * const obj = await bucket.upload(file, 'avatar.jpg', {
+     *   onProgress: pct => console.log(`${pct}%`)
+     * })
+     */
+    upload(file: File | Blob, name: string, options?: StorageUploadOptions): Promise<StorageObject>;
+    /**
+     * Retourne l'URL d'accès à un fichier.
+     *
+     * - Bucket **public**  : URL publique permanente, Bearer non requis.
+     * - Bucket **privé**   : URL signée (TTL 3600 s), Bearer requis, créateur uniquement.
+     */
+    getUrl(objectId: string): Promise<{
+        url: string;
+        expires_in?: number;
+    }>;
+    /**
+     * Supprime un fichier du bucket.
+     * Bearer requis. Seul le créateur du fichier peut le supprimer.
+     */
+    delete(objectId: string): Promise<void>;
+    /**
+     * PUT direct vers l'URL présignée OVH.
+     * Utilise XHR (si disponible) pour le suivi de progression, sinon fetch.
+     */
+    private _putToOvh;
+}
+
 /**
  * Client principal FrenchBaas.
  *
@@ -303,6 +428,8 @@ declare class CollectionClient<T = Record<string, unknown>> {
 declare class FrenchBaasClient {
     /** Module d'authentification — signUp, login, logout, getUser */
     readonly auth: AuthModule;
+    /** Module storage — listBuckets, bucket(id).upload / listObjects / getUrl / delete */
+    readonly storage: StorageModule;
     private readonly _http;
     private readonly _tokenStore;
     constructor(config: FrenchBaasConfig);
@@ -390,5 +517,13 @@ declare class RateLimitError extends FrenchBaasError {
 declare class ServerError extends FrenchBaasError {
     constructor(message?: string, status?: number);
 }
+/**
+ * Conflit de ressource — 409.
+ * Levée sur storage : un fichier avec ce nom existe déjà dans le bucket,
+ * déposé par un autre utilisateur.
+ */
+declare class ConflictError extends FrenchBaasError {
+    constructor(message?: string);
+}
 
-export { AuthError, type AuthResult, type CollectionSchema, type Document, type DocumentsPage, type FieldType, FrenchBaasClient as FrenchBaas, type FrenchBaasConfig, FrenchBaasError, type GetOptions, NetworkError, NotFoundError, type OpenApiSpec, type PaginationMeta, QuotaError, RateLimitError, type RefreshResult, type SchemaField, ServerError, type User, ValidationError };
+export { AuthError, type AuthResult, type CollectionSchema, ConflictError, type Document, type DocumentsPage, type FieldType, FrenchBaasClient as FrenchBaas, type FrenchBaasConfig, FrenchBaasError, type GetOptions, NetworkError, NotFoundError, type OpenApiSpec, type PaginationMeta, QuotaError, RateLimitError, type RefreshResult, type SchemaField, ServerError, type StorageBucket, type StorageListOptions, type StorageListResult, type StorageObject, type StorageUploadOptions, type User, ValidationError };

package/dist/index.d.ts

@@ -77,6 +77,44 @@ interface CollectionSchema {
     visibility: 'public' | 'authenticated' | 'private';
     schema: SchemaField[];
 }
+interface StorageBucket {
+    id: string;
+    name: string;
+    visibility: 'public' | 'private';
+    public: boolean;
+    created_at: string;
+}
+interface StorageObject {
+    id: string;
+    name: string;
+    content_type: string;
+    size: number;
+    created_by: string | null;
+    created_at: string;
+    /** URL publique — présente uniquement si le bucket est public */
+    url?: string;
+}
+interface StorageListOptions {
+    /** Numéro de page (défaut: 1) */
+    page?: number;
+    /** Fichiers par page — max 100 (défaut: 50) */
+    perPage?: number;
+    /** Filtre les fichiers dont le nom commence par ce préfixe */
+    prefix?: string;
+}
+interface StorageListResult {
+    data: StorageObject[];
+    meta: PaginationMeta;
+}
+interface StorageUploadOptions {
+    /** Force le Content-Type (sinon déduit de file.type) */
+    contentType?: string;
+    /**
+     * Callback appelé pendant le PUT vers OVH (0–100).
+     * Nécessite XMLHttpRequest (navigateur). Ignoré côté Node/SSR.
+     */
+    onProgress?: (pct: number) => void;
+}
 interface OpenApiSpec {
     openapi: string;
     info: Record<string, unknown>;
@@ -283,6 +321,93 @@ declare class CollectionClient<T = Record<string, unknown>> {
     schema(): Promise<CollectionSchema>;
 }
 
+/**
+ * Module storage — découverte des buckets et accès aux opérations par bucket.
+ *
+ * @example
+ * ```ts
+ * // Lister les buckets (pas de Bearer requis)
+ * const buckets = await client.storage.listBuckets()
+ *
+ * // Opérations sur un bucket spécifique
+ * const bucket = client.storage.bucket('bucket-uuid')
+ * const obj    = await bucket.upload(file, 'photo.jpg')
+ * const list   = await bucket.listObjects({ prefix: 'users/123/' })
+ * const { url } = await bucket.getUrl(obj.id)
+ * await bucket.delete(obj.id)
+ * ```
+ */
+declare class StorageModule {
+    private readonly _http;
+    constructor(_http: HttpClient);
+    /**
+     * Liste tous les buckets du projet.
+     *
+     * Authentification par API key uniquement — pas de Bearer requis.
+     * Usage principal : découverte des IDs pendant la construction de l'app.
+     */
+    listBuckets(): Promise<StorageBucket[]>;
+    /**
+     * Retourne un client pour opérer sur un bucket spécifique.
+     *
+     * @param bucketId UUID du bucket (visible dans Dashboard → Storage)
+     */
+    bucket(bucketId: string): StorageBucketClient;
+}
+/**
+ * Client pour les opérations sur un bucket spécifique.
+ */
+declare class StorageBucketClient {
+    private readonly _bucketId;
+    private readonly _http;
+    constructor(_bucketId: string, _http: HttpClient);
+    /**
+     * Liste les fichiers du bucket avec pagination et filtre préfixe.
+     *
+     * - Bucket **public** : Bearer non requis — retourne tous les fichiers.
+     * - Bucket **privé**  : Bearer requis — retourne uniquement les fichiers du user connecté.
+     *
+     * @example
+     * const { data, meta } = await bucket.listObjects({ prefix: 'users/123/', perPage: 20 })
+     */
+    listObjects(options?: StorageListOptions): Promise<StorageListResult>;
+    /**
+     * Upload un fichier en 3 étapes : présignature → PUT direct vers OVH → confirmation.
+     *
+     * Bearer requis. La progression PUT (0–100 %) peut être suivie via `options.onProgress`.
+     *
+     * @param file     Fichier ou Blob à uploader
+     * @param name     Nom dans le bucket (ex: "photo.jpg", "users/123/avatar.jpg")
+     * @param options  contentType (override), onProgress
+     *
+     * @example
+     * const obj = await bucket.upload(file, 'avatar.jpg', {
+     *   onProgress: pct => console.log(`${pct}%`)
+     * })
+     */
+    upload(file: File | Blob, name: string, options?: StorageUploadOptions): Promise<StorageObject>;
+    /**
+     * Retourne l'URL d'accès à un fichier.
+     *
+     * - Bucket **public**  : URL publique permanente, Bearer non requis.
+     * - Bucket **privé**   : URL signée (TTL 3600 s), Bearer requis, créateur uniquement.
+     */
+    getUrl(objectId: string): Promise<{
+        url: string;
+        expires_in?: number;
+    }>;
+    /**
+     * Supprime un fichier du bucket.
+     * Bearer requis. Seul le créateur du fichier peut le supprimer.
+     */
+    delete(objectId: string): Promise<void>;
+    /**
+     * PUT direct vers l'URL présignée OVH.
+     * Utilise XHR (si disponible) pour le suivi de progression, sinon fetch.
+     */
+    private _putToOvh;
+}
+
 /**
  * Client principal FrenchBaas.
  *
@@ -303,6 +428,8 @@ declare class CollectionClient<T = Record<string, unknown>> {
 declare class FrenchBaasClient {
     /** Module d'authentification — signUp, login, logout, getUser */
     readonly auth: AuthModule;
+    /** Module storage — listBuckets, bucket(id).upload / listObjects / getUrl / delete */
+    readonly storage: StorageModule;
     private readonly _http;
     private readonly _tokenStore;
     constructor(config: FrenchBaasConfig);
@@ -390,5 +517,13 @@ declare class RateLimitError extends FrenchBaasError {
 declare class ServerError extends FrenchBaasError {
     constructor(message?: string, status?: number);
 }
+/**
+ * Conflit de ressource — 409.
+ * Levée sur storage : un fichier avec ce nom existe déjà dans le bucket,
+ * déposé par un autre utilisateur.
+ */
+declare class ConflictError extends FrenchBaasError {
+    constructor(message?: string);
+}
 
-export { AuthError, type AuthResult, type CollectionSchema, type Document, type DocumentsPage, type FieldType, FrenchBaasClient as FrenchBaas, type FrenchBaasConfig, FrenchBaasError, type GetOptions, NetworkError, NotFoundError, type OpenApiSpec, type PaginationMeta, QuotaError, RateLimitError, type RefreshResult, type SchemaField, ServerError, type User, ValidationError };
+export { AuthError, type AuthResult, type CollectionSchema, ConflictError, type Document, type DocumentsPage, type FieldType, FrenchBaasClient as FrenchBaas, type FrenchBaasConfig, FrenchBaasError, type GetOptions, NetworkError, NotFoundError, type OpenApiSpec, type PaginationMeta, QuotaError, RateLimitError, type RefreshResult, type SchemaField, ServerError, type StorageBucket, type StorageListOptions, type StorageListResult, type StorageObject, type StorageUploadOptions, type User, ValidationError };

package/dist/index.js

@@ -57,6 +57,13 @@ var ServerError = class extends FrenchBaasError {
     Object.setPrototypeOf(this, new.target.prototype);
   }
 };
+var ConflictError = class extends FrenchBaasError {
+  constructor(message = "Conflit : la ressource existe d\xE9j\xE0.") {
+    super(message, 409);
+    this.name = "ConflictError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
 
 // src/auth.ts
 var AuthModule = class {
@@ -382,6 +389,8 @@ var HttpClient = class {
         const details = err.errors ?? [];
         throw new ValidationError(details.length ? details.join(", ") : msg, details);
       }
+      case 409:
+        throw new ConflictError(msg);
       case 429:
         throw new RateLimitError();
       default:
@@ -391,6 +400,139 @@ var HttpClient = class {
   }
 };
 
+// src/storage.ts
+var StorageModule = class {
+  constructor(_http) {
+    this._http = _http;
+  }
+  /**
+   * Liste tous les buckets du projet.
+   *
+   * Authentification par API key uniquement — pas de Bearer requis.
+   * Usage principal : découverte des IDs pendant la construction de l'app.
+   */
+  async listBuckets() {
+    const res = await this._http.get(
+      "/sdk/storage/buckets"
+    );
+    return res.data;
+  }
+  /**
+   * Retourne un client pour opérer sur un bucket spécifique.
+   *
+   * @param bucketId UUID du bucket (visible dans Dashboard → Storage)
+   */
+  bucket(bucketId) {
+    if (!bucketId || typeof bucketId !== "string") {
+      throw new Error("[FrenchBaas] storage.bucket() requiert un UUID de bucket valide.");
+    }
+    return new StorageBucketClient(bucketId, this._http);
+  }
+};
+var StorageBucketClient = class {
+  constructor(_bucketId, _http) {
+    this._bucketId = _bucketId;
+    this._http = _http;
+  }
+  /**
+   * Liste les fichiers du bucket avec pagination et filtre préfixe.
+   *
+   * - Bucket **public** : Bearer non requis — retourne tous les fichiers.
+   * - Bucket **privé**  : Bearer requis — retourne uniquement les fichiers du user connecté.
+   *
+   * @example
+   * const { data, meta } = await bucket.listObjects({ prefix: 'users/123/', perPage: 20 })
+   */
+  async listObjects(options = {}) {
+    const params = {};
+    if (options.page !== void 0) params["page"] = options.page;
+    if (options.perPage !== void 0) params["per_page"] = options.perPage;
+    if (options.prefix) params["prefix"] = options.prefix;
+    return this._http.get(
+      `/sdk/storage/buckets/${this._bucketId}/objects`,
+      params
+    );
+  }
+  /**
+   * Upload un fichier en 3 étapes : présignature → PUT direct vers OVH → confirmation.
+   *
+   * Bearer requis. La progression PUT (0–100 %) peut être suivie via `options.onProgress`.
+   *
+   * @param file     Fichier ou Blob à uploader
+   * @param name     Nom dans le bucket (ex: "photo.jpg", "users/123/avatar.jpg")
+   * @param options  contentType (override), onProgress
+   *
+   * @example
+   * const obj = await bucket.upload(file, 'avatar.jpg', {
+   *   onProgress: pct => console.log(`${pct}%`)
+   * })
+   */
+  async upload(file, name, options = {}) {
+    const contentType = options.contentType ?? ((file instanceof File ? file.type : "") || "application/octet-stream");
+    const presign = await this._http.post(`/sdk/storage/buckets/${this._bucketId}/upload`, {
+      name,
+      content_type: contentType,
+      size: file.size
+    });
+    await this._putToOvh(presign.upload_url, file, contentType, options.onProgress);
+    const confirm = await this._http.post(
+      `/sdk/storage/buckets/${this._bucketId}/confirm`,
+      { name, key: presign.key, content_type: contentType }
+    );
+    return confirm.data;
+  }
+  /**
+   * Retourne l'URL d'accès à un fichier.
+   *
+   * - Bucket **public**  : URL publique permanente, Bearer non requis.
+   * - Bucket **privé**   : URL signée (TTL 3600 s), Bearer requis, créateur uniquement.
+   */
+  async getUrl(objectId) {
+    return this._http.get(
+      `/sdk/storage/buckets/${this._bucketId}/objects/${objectId}/url`
+    );
+  }
+  /**
+   * Supprime un fichier du bucket.
+   * Bearer requis. Seul le créateur du fichier peut le supprimer.
+   */
+  async delete(objectId) {
+    await this._http.delete(`/sdk/storage/buckets/${this._bucketId}/objects/${objectId}`);
+  }
+  // ── Private ──────────────────────────────────────────────────────────────
+  /**
+   * PUT direct vers l'URL présignée OVH.
+   * Utilise XHR (si disponible) pour le suivi de progression, sinon fetch.
+   */
+  async _putToOvh(url, file, contentType, onProgress) {
+    if (typeof onProgress === "function" && typeof XMLHttpRequest !== "undefined") {
+      return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open("PUT", url);
+        xhr.setRequestHeader("Content-Type", contentType);
+        xhr.upload.addEventListener("progress", (e) => {
+          if (e.lengthComputable) onProgress(Math.round(e.loaded / e.total * 100));
+        });
+        xhr.addEventListener("load", () => {
+          if (xhr.status >= 200 && xhr.status < 300) resolve();
+          else reject(new NetworkError(`Upload OVH \xE9chou\xE9 (${xhr.status})`));
+        });
+        xhr.addEventListener(
+          "error",
+          () => reject(new NetworkError("Erreur r\xE9seau lors de l'upload OVH."))
+        );
+        xhr.send(file);
+      });
+    }
+    const res = await fetch(url, {
+      method: "PUT",
+      headers: { "Content-Type": contentType },
+      body: file
+    });
+    if (!res.ok) throw new NetworkError(`Upload OVH \xE9chou\xE9 (${res.status})`);
+  }
+};
+
 // src/token.ts
 var KEYS = {
   access: "frenchbaas_access_token",
@@ -505,6 +647,7 @@ var FrenchBaasClient = class {
     this._tokenStore = new TokenStore(config.storage ?? "memory");
     this._http = new HttpClient(baseUrl, config.apiKey, this._tokenStore);
     this.auth = new AuthModule(this._http, this._tokenStore, baseUrl, config.apiKey);
+    this.storage = new StorageModule(this._http);
   }
   /**
    * Retourne un client pour une collection spécifique.
@@ -535,6 +678,7 @@ var FrenchBaasClient = class {
 };
 export {
   AuthError,
+  ConflictError,
   FrenchBaasClient as FrenchBaas,
   FrenchBaasError,
   NetworkError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frenchbaas/js",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "SDK JavaScript officiel pour FrenchBaas",
   "author": "FrenchBaas",
   "license": "MIT",