@aurabase/aurabase-js 0.6.0 → 0.6.2

package/README.md

@@ -2,18 +2,24 @@
 
 Client JavaScript/TypeScript officiel pour [Aurabase](https://aurabase.cloud) : la plateforme Backend-as-a-Service open-source haute performance propulsée par Rust.
 
-[![npm version](https://img.shields.io/npm/v/@aurabase/aurabase-js)](https://www.npmjs.com/package/@aurabase/aurabase-js) [![license](https://img.shields.io/badge/license-MIT-blue)](https://github.com/daylami555/aurabase/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/@aurabase/aurabase-js)](https://www.npmjs.com/package/@aurabase/aurabase-js) [![license](https://img.shields.io/badge/license-MIT-blue)](https://github.com/Aurabase-cloud/Aurabase/blob/main/LICENSE)
 
 🌐 **Site officiel** : [https://aurabase.cloud](https://aurabase.cloud)  
 📖 **Documentation** : [https://aurabase.cloud/docs](https://aurabase.cloud)  
-🐙 **GitHub** : [daylami555/aurabase](https://github.com/daylami555/aurabase)
+🐙 **GitHub** : [Aurabase-cloud/Aurabase](https://github.com/Aurabase-cloud/Aurabase)
 
 ## Installation
 
 ```bash
 npm i @aurabase/aurabase-js
+# ou
+pnpm add @aurabase/aurabase-js
+yarn add @aurabase/aurabase-js
+bun add @aurabase/aurabase-js
 ```
 
+> **Attention au nom.** Le paquet officiel est `@aurabase/aurabase-js` (avec la portée `@aurabase/`). Le paquet `aurabase-js` sans portée n'est **pas** maintenu par Aurabase : ne l'installez pas.
+
 ## Rôle
 
 Ce package ne réimplémente aucune logique de service : il compose `AuthService`, `DatabaseService`, `StorageService`, `RealtimeService`, `FunctionsService`, `AiService` et `NotificationsService` (chacun dans son propre package `@aurabase/*`) derrière un seul client.
@@ -33,7 +39,7 @@ const { data, error } = await aura.db
   .from('posts')
   .select('id,title,published')
   .eq('published', true)
-  .order('created_at', 'desc')
+  .order('created_at', { ascending: false })
   .limit(10)
 
 if (error) {

package/dist/{AuraClient-5jDiXjrO.d.cts → AuraClient-BWdcX_k0.d.cts}

@@ -28,9 +28,21 @@ declare class AuraClient<Database = any, Schema extends GenericSchema = Database
 } ? S extends GenericSchema ? S : any : any> implements AuraClientLike {
     /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
     readonly baseUrl: string;
+    /**
+     * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+     */
     readonly apiKey: string | null;
+    /**
+     * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+     */
     readonly fetchFn: typeof globalThis.fetch;
+    /**
+     * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+     */
     readonly authStore: BaseAuthStore;
+    /**
+     * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+     */
     readonly retryConfig: {
         enabled: boolean;
         maxRetries: number;
@@ -64,13 +76,34 @@ declare class AuraClient<Database = any, Schema extends GenericSchema = Database
      * (React Strict Mode / HMR / tests).
      */
     dispose(): void;
+    /**
+     * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+     */
     get auth(): AuthService;
+    /**
+     * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+     * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+     */
     get authAdmin(): AuthAdminService;
+    /**
+     * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+     */
     get db(): DatabaseService<Database, Schema>;
+    /**
+     * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+     */
     get storage(): StorageService;
+    /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
     get realtime(): RealtimeService;
+    /**
+     * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+     */
     get functions(): FunctionsService;
+    /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
     get ai(): AiService;
+    /**
+     * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+     */
     get notifications(): NotificationsService;
     /**
      * Shortcut: query a database table or view (Supabase-compatible API).

package/dist/{AuraClient-5jDiXjrO.d.ts → AuraClient-BWdcX_k0.d.ts}

@@ -28,9 +28,21 @@ declare class AuraClient<Database = any, Schema extends GenericSchema = Database
 } ? S extends GenericSchema ? S : any : any> implements AuraClientLike {
     /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
     readonly baseUrl: string;
+    /**
+     * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+     */
     readonly apiKey: string | null;
+    /**
+     * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+     */
     readonly fetchFn: typeof globalThis.fetch;
+    /**
+     * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+     */
     readonly authStore: BaseAuthStore;
+    /**
+     * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+     */
     readonly retryConfig: {
         enabled: boolean;
         maxRetries: number;
@@ -64,13 +76,34 @@ declare class AuraClient<Database = any, Schema extends GenericSchema = Database
      * (React Strict Mode / HMR / tests).
      */
     dispose(): void;
+    /**
+     * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+     */
     get auth(): AuthService;
+    /**
+     * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+     * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+     */
     get authAdmin(): AuthAdminService;
+    /**
+     * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+     */
     get db(): DatabaseService<Database, Schema>;
+    /**
+     * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+     */
     get storage(): StorageService;
+    /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
     get realtime(): RealtimeService;
+    /**
+     * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+     */
     get functions(): FunctionsService;
+    /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
     get ai(): AiService;
+    /**
+     * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+     */
     get notifications(): NotificationsService;
     /**
      * Shortcut: query a database table or view (Supabase-compatible API).

package/dist/index.cjs

@@ -21,9 +21,21 @@ var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
   /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
+  /**
+   * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+   */
   apiKey;
+  /**
+   * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+   */
   fetchFn;
+  /**
+   * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+   */
   authStore;
+  /**
+   * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+   */
   retryConfig;
   /** Timeout par défaut (ms) des requêtes JSON sans signal. `undefined` → défaut core (30s). */
   requestTimeoutMs;
@@ -49,6 +61,21 @@ var AuraClient = class {
    * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
    */
   constructor(baseUrl, apiKey, options) {
+    if (typeof baseUrl !== "string" || baseUrl.trim() === "") {
+      throw new Error(
+        "[aurabase] Project URL is required: set NEXT_PUBLIC_AURABASE_URL to the project URL shown in Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080), then pass it to createClient(url, key)."
+      );
+    }
+    if (!/^https?:\/\//i.test(baseUrl.trim())) {
+      throw new Error(
+        `[aurabase] baseUrl must start with http:// or https:// (got "${baseUrl}"): copy the project URL from Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080).`
+      );
+    }
+    if (apiKey === void 0 || apiKey === null) {
+      throw new Error(
+        "[aurabase] API key is required: set NEXT_PUBLIC_AURABASE_ANON_KEY (browser) or AURABASE_SERVICE_ROLE_KEY (server only) to a key shown in Studio \u203A Settings \u203A Connection, then pass it to createClient(url, key)."
+      );
+    }
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     const resolvedOptions = options;
     this.apiKey = apiKey || null;
@@ -111,6 +138,9 @@ var AuraClient = class {
     this._realtime?.disconnect();
   }
   // -- Lazy service getters ---------------------------------------------------
+  /**
+   * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+   */
   get auth() {
     if (!this._auth) {
       this._auth = new auth.AuthService(this, {
@@ -130,6 +160,10 @@ var AuraClient = class {
     }
     return this._auth;
   }
+  /**
+   * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+   * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+   */
   get authAdmin() {
     if (isBrowserContext()) {
       throw new Error(
@@ -139,26 +173,40 @@ var AuraClient = class {
     if (!this._authAdmin) this._authAdmin = new auth.AuthAdminService(this);
     return this._authAdmin;
   }
+  /**
+   * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+   */
   get db() {
     if (!this._db) this._db = new db.DatabaseService(this);
     return this._db;
   }
+  /**
+   * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+   */
   get storage() {
     if (!this._storage) this._storage = new storage.StorageService(this);
     return this._storage;
   }
+  /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
   get realtime() {
     if (!this._realtime) this._realtime = new realtime.RealtimeService(this);
     return this._realtime;
   }
+  /**
+   * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+   */
   get functions() {
     if (!this._functions) this._functions = new functions.FunctionsService(this);
     return this._functions;
   }
+  /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
   get ai() {
     if (!this._ai) this._ai = new ai.AiService(this);
     return this._ai;
   }
+  /**
+   * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+   */
   get notifications() {
     if (!this._notifications) this._notifications = new notifications.NotificationsService(this);
     return this._notifications;

package/dist/index.d.cts

@@ -1,13 +1,13 @@
 export { AiService } from '@aurabase/ai';
 export { AuthAdminService, AuthService, isMfaChallenge } from '@aurabase/auth';
 import { AuraClientOptions } from '@aurabase/core';
-export { AdminCreateUserRequest, AdminUpdateUserRequest, AdminUser, AuditLogEntry, AuraClientOptions, AuraError, AuraErrorCode, AuraObservabilityEvent, AuraResponse, AuthChangePayload, AuthEvent, AuthSettings, AuthSettingsUpdate, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, BroadcastSendStatus, ChannelConfig, ChatMessage, ChatResponse, CountMode, CreatePgFunctionRequest, CreatePgTriggerRequest, CronJob, EmailTemplateUpdate, EmbedRequest, EmbedResponse, FileEntry, FilterOp, FunctionDef, IdentityInfo, Job, LocalAuthStore, LoginResponse, MagicLinkRequest, Meta, MfaChallenge, MfaEnrollResponse, MfaVerifyRequest, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, OAuthProviderSetting, OAuthSignInOptions, PasswordResetRequest, PgExecutableRole, PgFunctionInfo, PgTriggerInfo, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, SchemaEnum, SchemaFunction, SchemaFunctionArg, SchemaTable, SemanticSearchResult, SendNotificationRequest, SessionInfo, SignInRequest, SignUpRequest, StorageBucket, TokenPair, UpdateUserRequest, UploadResult, User, isAuraError } from '@aurabase/core';
+export { AdminCreateUserRequest, AdminUpdateUserRequest, AdminUser, AuditLogEntry, AuraClientOptions, AuraError, AuraErrorCode, AuraObservabilityEvent, AuraResponse, AuthChangePayload, AuthEvent, AuthSettings, AuthSettingsUpdate, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, BroadcastSendStatus, ChannelConfig, ChatMessage, ChatResponse, CountMode, CreatePgFunctionRequest, CreatePgTriggerRequest, CronJob, EmailTemplateUpdate, EmbedRequest, EmbedResponse, FileEntry, FilterOp, FunctionDef, FunctionPermissions, IdentityInfo, Job, LocalAuthStore, LoginResponse, MagicLinkRequest, Meta, MfaChallenge, MfaEnrollResponse, MfaVerifyRequest, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, OAuthProviderSetting, OAuthSignInOptions, PasswordResetRequest, PgExecutableRole, PgFunctionInfo, PgTriggerInfo, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, SchemaEnum, SchemaFunction, SchemaFunctionArg, SchemaTable, SemanticSearchResult, SendNotificationRequest, SessionInfo, SignInRequest, SignUpRequest, StorageBucket, TokenPair, UpdateUserRequest, UploadResult, User, isAuraError } from '@aurabase/core';
 export { DatabaseService, QueryBuilder } from '@aurabase/db';
 export { FunctionsHttpError, FunctionsRelayError, FunctionsResponseType, FunctionsService, isRelayStatus } from '@aurabase/functions';
 export { NotificationsAdminService, NotificationsService } from '@aurabase/notifications';
 export { AuraChannel, RealtimeService } from '@aurabase/realtime';
 export { StorageBucketClient, StorageService } from '@aurabase/storage';
-import { A as AuraClient } from './AuraClient-5jDiXjrO.cjs';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.cjs';
 
 /**
  * Create a new Aurabase client instance.
@@ -38,7 +38,7 @@ declare function createClient<Database = any>(baseUrl: string, apiKey: string, o
  * @example
  * ```ts
  * // server-side only (API route, edge function, backend)
- * const admin = createAdminClient(projectUrl, process.env.SERVICE_ROLE_KEY!)
+ * const admin = createAdminClient(projectUrl, process.env.AURABASE_SERVICE_ROLE_KEY!)
  * await admin.authAdmin.listUsers()
  * ```
  */

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 export { AiService } from '@aurabase/ai';
 export { AuthAdminService, AuthService, isMfaChallenge } from '@aurabase/auth';
 import { AuraClientOptions } from '@aurabase/core';
-export { AdminCreateUserRequest, AdminUpdateUserRequest, AdminUser, AuditLogEntry, AuraClientOptions, AuraError, AuraErrorCode, AuraObservabilityEvent, AuraResponse, AuthChangePayload, AuthEvent, AuthSettings, AuthSettingsUpdate, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, BroadcastSendStatus, ChannelConfig, ChatMessage, ChatResponse, CountMode, CreatePgFunctionRequest, CreatePgTriggerRequest, CronJob, EmailTemplateUpdate, EmbedRequest, EmbedResponse, FileEntry, FilterOp, FunctionDef, IdentityInfo, Job, LocalAuthStore, LoginResponse, MagicLinkRequest, Meta, MfaChallenge, MfaEnrollResponse, MfaVerifyRequest, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, OAuthProviderSetting, OAuthSignInOptions, PasswordResetRequest, PgExecutableRole, PgFunctionInfo, PgTriggerInfo, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, SchemaEnum, SchemaFunction, SchemaFunctionArg, SchemaTable, SemanticSearchResult, SendNotificationRequest, SessionInfo, SignInRequest, SignUpRequest, StorageBucket, TokenPair, UpdateUserRequest, UploadResult, User, isAuraError } from '@aurabase/core';
+export { AdminCreateUserRequest, AdminUpdateUserRequest, AdminUser, AuditLogEntry, AuraClientOptions, AuraError, AuraErrorCode, AuraObservabilityEvent, AuraResponse, AuthChangePayload, AuthEvent, AuthSettings, AuthSettingsUpdate, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, BroadcastSendStatus, ChannelConfig, ChatMessage, ChatResponse, CountMode, CreatePgFunctionRequest, CreatePgTriggerRequest, CronJob, EmailTemplateUpdate, EmbedRequest, EmbedResponse, FileEntry, FilterOp, FunctionDef, FunctionPermissions, IdentityInfo, Job, LocalAuthStore, LoginResponse, MagicLinkRequest, Meta, MfaChallenge, MfaEnrollResponse, MfaVerifyRequest, Notification, NotificationAttempt, NotificationDeadLetter, NotificationEvent, NotificationProviderLog, NotificationQueueStats, NotificationRule, NotificationSettings, NotificationStats, NotificationTemplate, NotificationTemplatePreview, OAuthProviderSetting, OAuthSignInOptions, PasswordResetRequest, PgExecutableRole, PgFunctionInfo, PgTriggerInfo, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, SchemaEnum, SchemaFunction, SchemaFunctionArg, SchemaTable, SemanticSearchResult, SendNotificationRequest, SessionInfo, SignInRequest, SignUpRequest, StorageBucket, TokenPair, UpdateUserRequest, UploadResult, User, isAuraError } from '@aurabase/core';
 export { DatabaseService, QueryBuilder } from '@aurabase/db';
 export { FunctionsHttpError, FunctionsRelayError, FunctionsResponseType, FunctionsService, isRelayStatus } from '@aurabase/functions';
 export { NotificationsAdminService, NotificationsService } from '@aurabase/notifications';
 export { AuraChannel, RealtimeService } from '@aurabase/realtime';
 export { StorageBucketClient, StorageService } from '@aurabase/storage';
-import { A as AuraClient } from './AuraClient-5jDiXjrO.js';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.js';
 
 /**
  * Create a new Aurabase client instance.
@@ -38,7 +38,7 @@ declare function createClient<Database = any>(baseUrl: string, apiKey: string, o
  * @example
  * ```ts
  * // server-side only (API route, edge function, backend)
- * const admin = createAdminClient(projectUrl, process.env.SERVICE_ROLE_KEY!)
+ * const admin = createAdminClient(projectUrl, process.env.AURABASE_SERVICE_ROLE_KEY!)
  * await admin.authAdmin.listUsers()
  * ```
  */

package/dist/index.js

@@ -27,9 +27,21 @@ var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
   /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
+  /**
+   * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+   */
   apiKey;
+  /**
+   * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+   */
   fetchFn;
+  /**
+   * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+   */
   authStore;
+  /**
+   * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+   */
   retryConfig;
   /** Timeout par défaut (ms) des requêtes JSON sans signal. `undefined` → défaut core (30s). */
   requestTimeoutMs;
@@ -55,6 +67,21 @@ var AuraClient = class {
    * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
    */
   constructor(baseUrl, apiKey, options) {
+    if (typeof baseUrl !== "string" || baseUrl.trim() === "") {
+      throw new Error(
+        "[aurabase] Project URL is required: set NEXT_PUBLIC_AURABASE_URL to the project URL shown in Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080), then pass it to createClient(url, key)."
+      );
+    }
+    if (!/^https?:\/\//i.test(baseUrl.trim())) {
+      throw new Error(
+        `[aurabase] baseUrl must start with http:// or https:// (got "${baseUrl}"): copy the project URL from Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080).`
+      );
+    }
+    if (apiKey === void 0 || apiKey === null) {
+      throw new Error(
+        "[aurabase] API key is required: set NEXT_PUBLIC_AURABASE_ANON_KEY (browser) or AURABASE_SERVICE_ROLE_KEY (server only) to a key shown in Studio \u203A Settings \u203A Connection, then pass it to createClient(url, key)."
+      );
+    }
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     const resolvedOptions = options;
     this.apiKey = apiKey || null;
@@ -117,6 +144,9 @@ var AuraClient = class {
     this._realtime?.disconnect();
   }
   // -- Lazy service getters ---------------------------------------------------
+  /**
+   * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+   */
   get auth() {
     if (!this._auth) {
       this._auth = new AuthService(this, {
@@ -136,6 +166,10 @@ var AuraClient = class {
     }
     return this._auth;
   }
+  /**
+   * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+   * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+   */
   get authAdmin() {
     if (isBrowserContext()) {
       throw new Error(
@@ -145,26 +179,40 @@ var AuraClient = class {
     if (!this._authAdmin) this._authAdmin = new AuthAdminService(this);
     return this._authAdmin;
   }
+  /**
+   * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+   */
   get db() {
     if (!this._db) this._db = new DatabaseService(this);
     return this._db;
   }
+  /**
+   * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+   */
   get storage() {
     if (!this._storage) this._storage = new StorageService(this);
     return this._storage;
   }
+  /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
   get realtime() {
     if (!this._realtime) this._realtime = new RealtimeService(this);
     return this._realtime;
   }
+  /**
+   * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+   */
   get functions() {
     if (!this._functions) this._functions = new FunctionsService(this);
     return this._functions;
   }
+  /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
   get ai() {
     if (!this._ai) this._ai = new AiService(this);
     return this._ai;
   }
+  /**
+   * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+   */
   get notifications() {
     if (!this._notifications) this._notifications = new NotificationsService(this);
     return this._notifications;

package/dist/nextjs.cjs

@@ -21,9 +21,21 @@ var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
   /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
+  /**
+   * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+   */
   apiKey;
+  /**
+   * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+   */
   fetchFn;
+  /**
+   * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+   */
   authStore;
+  /**
+   * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+   */
   retryConfig;
   /** Timeout par défaut (ms) des requêtes JSON sans signal. `undefined` → défaut core (30s). */
   requestTimeoutMs;
@@ -49,6 +61,21 @@ var AuraClient = class {
    * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
    */
   constructor(baseUrl, apiKey, options) {
+    if (typeof baseUrl !== "string" || baseUrl.trim() === "") {
+      throw new Error(
+        "[aurabase] Project URL is required: set NEXT_PUBLIC_AURABASE_URL to the project URL shown in Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080), then pass it to createClient(url, key)."
+      );
+    }
+    if (!/^https?:\/\//i.test(baseUrl.trim())) {
+      throw new Error(
+        `[aurabase] baseUrl must start with http:// or https:// (got "${baseUrl}"): copy the project URL from Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080).`
+      );
+    }
+    if (apiKey === void 0 || apiKey === null) {
+      throw new Error(
+        "[aurabase] API key is required: set NEXT_PUBLIC_AURABASE_ANON_KEY (browser) or AURABASE_SERVICE_ROLE_KEY (server only) to a key shown in Studio \u203A Settings \u203A Connection, then pass it to createClient(url, key)."
+      );
+    }
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     const resolvedOptions = options;
     this.apiKey = apiKey || null;
@@ -111,6 +138,9 @@ var AuraClient = class {
     this._realtime?.disconnect();
   }
   // -- Lazy service getters ---------------------------------------------------
+  /**
+   * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+   */
   get auth() {
     if (!this._auth) {
       this._auth = new auth$1.AuthService(this, {
@@ -130,6 +160,10 @@ var AuraClient = class {
     }
     return this._auth;
   }
+  /**
+   * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+   * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+   */
   get authAdmin() {
     if (isBrowserContext()) {
       throw new Error(
@@ -139,26 +173,40 @@ var AuraClient = class {
     if (!this._authAdmin) this._authAdmin = new auth$1.AuthAdminService(this);
     return this._authAdmin;
   }
+  /**
+   * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+   */
   get db() {
     if (!this._db) this._db = new db.DatabaseService(this);
     return this._db;
   }
+  /**
+   * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+   */
   get storage() {
     if (!this._storage) this._storage = new storage.StorageService(this);
     return this._storage;
   }
+  /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
   get realtime() {
     if (!this._realtime) this._realtime = new realtime.RealtimeService(this);
     return this._realtime;
   }
+  /**
+   * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+   */
   get functions() {
     if (!this._functions) this._functions = new functions.FunctionsService(this);
     return this._functions;
   }
+  /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
   get ai() {
     if (!this._ai) this._ai = new ai.AiService(this);
     return this._ai;
   }
+  /**
+   * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+   */
   get notifications() {
     if (!this._notifications) this._notifications = new notifications.NotificationsService(this);
     return this._notifications;
@@ -230,7 +278,7 @@ function createServerClient(baseUrl, apiKey, options) {
   const defaultCookieOpts = {
     path: "/",
     secure: baseUrl.startsWith("https://"),
-    sameSite: "Lax",
+    sameSite: "lax",
     httpOnly: true,
     maxAge: 60 * 60 * 24 * 30,
     // 30 days
@@ -292,8 +340,8 @@ function createAuthMiddleware(options = {}) {
       );
     }
     const { NextResponse } = nextServer;
-    const projectUrl = options.projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? process.env.AURABASE_URL ?? "";
-    const anonKey = options.anonKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? process.env.AURABASE_ANON_KEY ?? "";
+    const projectUrl = options.projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? "";
+    const anonKey = options.anonKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? "";
     if (!projectUrl || !anonKey) {
       console.warn(
         "[@aurabase/nextjs] Variables d'environnement manquantes : NEXT_PUBLIC_AURABASE_URL ou NEXT_PUBLIC_AURABASE_ANON_KEY non d\xE9finies."
@@ -337,8 +385,8 @@ function createAuthMiddleware(options = {}) {
   };
 }
 function createClientForServerComponent(cookieStore, projectUrl, apiKey) {
-  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? process.env.AURABASE_URL ?? "";
-  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? process.env.AURABASE_ANON_KEY ?? "";
+  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? "";
+  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? "";
   return createServerClient(url, key, {
     cookies: {
       getAll: () => cookieStore.getAll(),
@@ -348,8 +396,8 @@ function createClientForServerComponent(cookieStore, projectUrl, apiKey) {
   });
 }
 function createClientForServerAction(cookieStore, projectUrl, apiKey) {
-  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? process.env.AURABASE_URL ?? "";
-  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? process.env.AURABASE_ANON_KEY ?? "";
+  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? "";
+  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? "";
   return createServerClient(url, key, {
     cookies: {
       getAll: () => cookieStore.getAll(),

package/dist/nextjs.d.cts

@@ -1,4 +1,4 @@
-import { A as AuraClient } from './AuraClient-5jDiXjrO.cjs';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.cjs';
 import { User, Session } from '@aurabase/core';
 import '@aurabase/ai';
 import '@aurabase/auth';
@@ -53,9 +53,9 @@ interface AuthContextParam {
     request: NextRequestLike;
 }
 interface AuthMiddlewareOptions {
-    /** Project URL (defaults to process.env.NEXT_PUBLIC_AURABASE_URL or process.env.AURABASE_URL). */
+    /** Project URL (defaults to process.env.NEXT_PUBLIC_AURABASE_URL — J1-004 : seul nom reconnu). */
     projectUrl?: string;
-    /** Anon API Key (defaults to process.env.NEXT_PUBLIC_AURABASE_ANON_KEY or process.env.AURABASE_ANON_KEY). */
+    /** Anon API Key (defaults to process.env.NEXT_PUBLIC_AURABASE_ANON_KEY — J1-004 : seul nom reconnu). */
     anonKey?: string;
     /** List of route patterns that do not require authentication (e.g. ['/', '/login', '/signup', '/auth/*']). */
     publicRoutes?: string[];

package/dist/nextjs.d.ts

@@ -1,4 +1,4 @@
-import { A as AuraClient } from './AuraClient-5jDiXjrO.js';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.js';
 import { User, Session } from '@aurabase/core';
 import '@aurabase/ai';
 import '@aurabase/auth';
@@ -53,9 +53,9 @@ interface AuthContextParam {
     request: NextRequestLike;
 }
 interface AuthMiddlewareOptions {
-    /** Project URL (defaults to process.env.NEXT_PUBLIC_AURABASE_URL or process.env.AURABASE_URL). */
+    /** Project URL (defaults to process.env.NEXT_PUBLIC_AURABASE_URL — J1-004 : seul nom reconnu). */
     projectUrl?: string;
-    /** Anon API Key (defaults to process.env.NEXT_PUBLIC_AURABASE_ANON_KEY or process.env.AURABASE_ANON_KEY). */
+    /** Anon API Key (defaults to process.env.NEXT_PUBLIC_AURABASE_ANON_KEY — J1-004 : seul nom reconnu). */
     anonKey?: string;
     /** List of route patterns that do not require authentication (e.g. ['/', '/login', '/signup', '/auth/*']). */
     publicRoutes?: string[];

package/dist/nextjs.js

@@ -19,9 +19,21 @@ var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
   /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
+  /**
+   * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+   */
   apiKey;
+  /**
+   * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+   */
   fetchFn;
+  /**
+   * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+   */
   authStore;
+  /**
+   * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+   */
   retryConfig;
   /** Timeout par défaut (ms) des requêtes JSON sans signal. `undefined` → défaut core (30s). */
   requestTimeoutMs;
@@ -47,6 +59,21 @@ var AuraClient = class {
    * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
    */
   constructor(baseUrl, apiKey, options) {
+    if (typeof baseUrl !== "string" || baseUrl.trim() === "") {
+      throw new Error(
+        "[aurabase] Project URL is required: set NEXT_PUBLIC_AURABASE_URL to the project URL shown in Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080), then pass it to createClient(url, key)."
+      );
+    }
+    if (!/^https?:\/\//i.test(baseUrl.trim())) {
+      throw new Error(
+        `[aurabase] baseUrl must start with http:// or https:// (got "${baseUrl}"): copy the project URL from Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080).`
+      );
+    }
+    if (apiKey === void 0 || apiKey === null) {
+      throw new Error(
+        "[aurabase] API key is required: set NEXT_PUBLIC_AURABASE_ANON_KEY (browser) or AURABASE_SERVICE_ROLE_KEY (server only) to a key shown in Studio \u203A Settings \u203A Connection, then pass it to createClient(url, key)."
+      );
+    }
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     const resolvedOptions = options;
     this.apiKey = apiKey || null;
@@ -109,6 +136,9 @@ var AuraClient = class {
     this._realtime?.disconnect();
   }
   // -- Lazy service getters ---------------------------------------------------
+  /**
+   * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+   */
   get auth() {
     if (!this._auth) {
       this._auth = new AuthService(this, {
@@ -128,6 +158,10 @@ var AuraClient = class {
     }
     return this._auth;
   }
+  /**
+   * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+   * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+   */
   get authAdmin() {
     if (isBrowserContext()) {
       throw new Error(
@@ -137,26 +171,40 @@ var AuraClient = class {
     if (!this._authAdmin) this._authAdmin = new AuthAdminService(this);
     return this._authAdmin;
   }
+  /**
+   * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+   */
   get db() {
     if (!this._db) this._db = new DatabaseService(this);
     return this._db;
   }
+  /**
+   * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+   */
   get storage() {
     if (!this._storage) this._storage = new StorageService(this);
     return this._storage;
   }
+  /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
   get realtime() {
     if (!this._realtime) this._realtime = new RealtimeService(this);
     return this._realtime;
   }
+  /**
+   * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+   */
   get functions() {
     if (!this._functions) this._functions = new FunctionsService(this);
     return this._functions;
   }
+  /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
   get ai() {
     if (!this._ai) this._ai = new AiService(this);
     return this._ai;
   }
+  /**
+   * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+   */
   get notifications() {
     if (!this._notifications) this._notifications = new NotificationsService(this);
     return this._notifications;
@@ -228,7 +276,7 @@ function createServerClient(baseUrl, apiKey, options) {
   const defaultCookieOpts = {
     path: "/",
     secure: baseUrl.startsWith("https://"),
-    sameSite: "Lax",
+    sameSite: "lax",
     httpOnly: true,
     maxAge: 60 * 60 * 24 * 30,
     // 30 days
@@ -290,8 +338,8 @@ function createAuthMiddleware(options = {}) {
       );
     }
     const { NextResponse } = nextServer;
-    const projectUrl = options.projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? process.env.AURABASE_URL ?? "";
-    const anonKey = options.anonKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? process.env.AURABASE_ANON_KEY ?? "";
+    const projectUrl = options.projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? "";
+    const anonKey = options.anonKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? "";
     if (!projectUrl || !anonKey) {
       console.warn(
         "[@aurabase/nextjs] Variables d'environnement manquantes : NEXT_PUBLIC_AURABASE_URL ou NEXT_PUBLIC_AURABASE_ANON_KEY non d\xE9finies."
@@ -335,8 +383,8 @@ function createAuthMiddleware(options = {}) {
   };
 }
 function createClientForServerComponent(cookieStore, projectUrl, apiKey) {
-  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? process.env.AURABASE_URL ?? "";
-  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? process.env.AURABASE_ANON_KEY ?? "";
+  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? "";
+  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? "";
   return createServerClient(url, key, {
     cookies: {
       getAll: () => cookieStore.getAll(),
@@ -346,8 +394,8 @@ function createClientForServerComponent(cookieStore, projectUrl, apiKey) {
   });
 }
 function createClientForServerAction(cookieStore, projectUrl, apiKey) {
-  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? process.env.AURABASE_URL ?? "";
-  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? process.env.AURABASE_ANON_KEY ?? "";
+  const url = projectUrl ?? process.env.NEXT_PUBLIC_AURABASE_URL ?? "";
+  const key = apiKey ?? process.env.NEXT_PUBLIC_AURABASE_ANON_KEY ?? "";
   return createServerClient(url, key, {
     cookies: {
       getAll: () => cookieStore.getAll(),

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import { User, Session } from '@aurabase/core';
-import { A as AuraClient } from './AuraClient-5jDiXjrO.cjs';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.cjs';
 import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { User, Session } from '@aurabase/core';
-import { A as AuraClient } from './AuraClient-5jDiXjrO.js';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.js';
 import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';

package/dist/ssr.cjs

@@ -21,9 +21,21 @@ var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
   /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
+  /**
+   * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+   */
   apiKey;
+  /**
+   * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+   */
   fetchFn;
+  /**
+   * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+   */
   authStore;
+  /**
+   * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+   */
   retryConfig;
   /** Timeout par défaut (ms) des requêtes JSON sans signal. `undefined` → défaut core (30s). */
   requestTimeoutMs;
@@ -49,6 +61,21 @@ var AuraClient = class {
    * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
    */
   constructor(baseUrl, apiKey, options) {
+    if (typeof baseUrl !== "string" || baseUrl.trim() === "") {
+      throw new Error(
+        "[aurabase] Project URL is required: set NEXT_PUBLIC_AURABASE_URL to the project URL shown in Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080), then pass it to createClient(url, key)."
+      );
+    }
+    if (!/^https?:\/\//i.test(baseUrl.trim())) {
+      throw new Error(
+        `[aurabase] baseUrl must start with http:// or https:// (got "${baseUrl}"): copy the project URL from Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080).`
+      );
+    }
+    if (apiKey === void 0 || apiKey === null) {
+      throw new Error(
+        "[aurabase] API key is required: set NEXT_PUBLIC_AURABASE_ANON_KEY (browser) or AURABASE_SERVICE_ROLE_KEY (server only) to a key shown in Studio \u203A Settings \u203A Connection, then pass it to createClient(url, key)."
+      );
+    }
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     const resolvedOptions = options;
     this.apiKey = apiKey || null;
@@ -111,6 +138,9 @@ var AuraClient = class {
     this._realtime?.disconnect();
   }
   // -- Lazy service getters ---------------------------------------------------
+  /**
+   * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+   */
   get auth() {
     if (!this._auth) {
       this._auth = new auth.AuthService(this, {
@@ -130,6 +160,10 @@ var AuraClient = class {
     }
     return this._auth;
   }
+  /**
+   * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+   * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+   */
   get authAdmin() {
     if (isBrowserContext()) {
       throw new Error(
@@ -139,26 +173,40 @@ var AuraClient = class {
     if (!this._authAdmin) this._authAdmin = new auth.AuthAdminService(this);
     return this._authAdmin;
   }
+  /**
+   * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+   */
   get db() {
     if (!this._db) this._db = new db.DatabaseService(this);
     return this._db;
   }
+  /**
+   * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+   */
   get storage() {
     if (!this._storage) this._storage = new storage.StorageService(this);
     return this._storage;
   }
+  /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
   get realtime() {
     if (!this._realtime) this._realtime = new realtime.RealtimeService(this);
     return this._realtime;
   }
+  /**
+   * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+   */
   get functions() {
     if (!this._functions) this._functions = new functions.FunctionsService(this);
     return this._functions;
   }
+  /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
   get ai() {
     if (!this._ai) this._ai = new ai.AiService(this);
     return this._ai;
   }
+  /**
+   * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+   */
   get notifications() {
     if (!this._notifications) this._notifications = new notifications.NotificationsService(this);
     return this._notifications;
@@ -230,7 +278,7 @@ function createServerClient(baseUrl, apiKey, options) {
   const defaultCookieOpts = {
     path: "/",
     secure: baseUrl.startsWith("https://"),
-    sameSite: "Lax",
+    sameSite: "lax",
     httpOnly: true,
     maxAge: 60 * 60 * 24 * 30,
     // 30 days

package/dist/ssr.d.cts

@@ -1,6 +1,6 @@
 import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
 export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
-import { A as AuraClient } from './AuraClient-5jDiXjrO.cjs';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.cjs';
 import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';
@@ -18,7 +18,7 @@ import '@aurabase/storage';
  *
  * export async function middleware(request) {
  *   let response = NextResponse.next({ request })
- *   const client = createServerClient(PROJECT_URL, ANON_KEY, {
+ *   const client = createServerClient(NEXT_PUBLIC_AURABASE_URL, NEXT_PUBLIC_AURABASE_ANON_KEY, {
  *     cookies: {
  *       getAll: () => request.cookies.getAll(),
  *       setAll: (cookies) => {

package/dist/ssr.d.ts

@@ -1,6 +1,6 @@
 import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
 export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
-import { A as AuraClient } from './AuraClient-5jDiXjrO.js';
+import { A as AuraClient } from './AuraClient-BWdcX_k0.js';
 import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';
@@ -18,7 +18,7 @@ import '@aurabase/storage';
  *
  * export async function middleware(request) {
  *   let response = NextResponse.next({ request })
- *   const client = createServerClient(PROJECT_URL, ANON_KEY, {
+ *   const client = createServerClient(NEXT_PUBLIC_AURABASE_URL, NEXT_PUBLIC_AURABASE_ANON_KEY, {
  *     cookies: {
  *       getAll: () => request.cookies.getAll(),
  *       setAll: (cookies) => {

package/dist/ssr.js

@@ -20,9 +20,21 @@ var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
   /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
+  /**
+   * Clé API du projet (`anon` ou `service_role`) envoyée dans l'en-tête `apikey` ; `null` si aucune n'a été fournie.
+   */
   apiKey;
+  /**
+   * Fonction `fetch` utilisée pour toutes les requêtes (celle de `options.fetch`, sinon `globalThis.fetch`).
+   */
   fetchFn;
+  /**
+   * Magasin de session (jeton d'accès, jeton de rafraîchissement, utilisateur) : mémoire, `localStorage` ou cookies selon le contexte.
+   */
   authStore;
+  /**
+   * Politique de reprise des requêtes de lecture (`GET`, `HEAD`) sur erreur transitoire : activée ou non, et nombre maximal de reprises.
+   */
   retryConfig;
   /** Timeout par défaut (ms) des requêtes JSON sans signal. `undefined` → défaut core (30s). */
   requestTimeoutMs;
@@ -48,6 +60,21 @@ var AuraClient = class {
    * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
    */
   constructor(baseUrl, apiKey, options) {
+    if (typeof baseUrl !== "string" || baseUrl.trim() === "") {
+      throw new Error(
+        "[aurabase] Project URL is required: set NEXT_PUBLIC_AURABASE_URL to the project URL shown in Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080), then pass it to createClient(url, key)."
+      );
+    }
+    if (!/^https?:\/\//i.test(baseUrl.trim())) {
+      throw new Error(
+        `[aurabase] baseUrl must start with http:// or https:// (got "${baseUrl}"): copy the project URL from Studio \u203A Settings \u203A Connection (e.g. http://<slug>.localhost:8080).`
+      );
+    }
+    if (apiKey === void 0 || apiKey === null) {
+      throw new Error(
+        "[aurabase] API key is required: set NEXT_PUBLIC_AURABASE_ANON_KEY (browser) or AURABASE_SERVICE_ROLE_KEY (server only) to a key shown in Studio \u203A Settings \u203A Connection, then pass it to createClient(url, key)."
+      );
+    }
     this.baseUrl = baseUrl.replace(/\/+$/, "");
     const resolvedOptions = options;
     this.apiKey = apiKey || null;
@@ -110,6 +137,9 @@ var AuraClient = class {
     this._realtime?.disconnect();
   }
   // -- Lazy service getters ---------------------------------------------------
+  /**
+   * Service d'authentification : inscription, connexion, session, MFA, OAuth, identités. Créé à la première utilisation.
+   */
   get auth() {
     if (!this._auth) {
       this._auth = new AuthService(this, {
@@ -129,6 +159,10 @@ var AuraClient = class {
     }
     return this._auth;
   }
+  /**
+   * API d'administration de l'authentification (utilisateurs, sessions, journal d'audit, modèles d'e-mail).
+   * Exige une clé `service_role` et lève une erreur dans un navigateur : utilisez `createAdminClient()` côté serveur.
+   */
   get authAdmin() {
     if (isBrowserContext()) {
       throw new Error(
@@ -138,26 +172,40 @@ var AuraClient = class {
     if (!this._authAdmin) this._authAdmin = new AuthAdminService(this);
     return this._authAdmin;
   }
+  /**
+   * Service de base de données : requêtes sur les tables et vues, appels de fonctions SQL (`rpc`), SQL brut.
+   */
   get db() {
     if (!this._db) this._db = new DatabaseService(this);
     return this._db;
   }
+  /**
+   * Service de stockage : buckets, envoi, téléchargement, URL signées et publiques, transformations d'image.
+   */
   get storage() {
     if (!this._storage) this._storage = new StorageService(this);
     return this._storage;
   }
+  /** Service temps réel : canaux, changements Postgres, diffusion (`broadcast`) et présence. */
   get realtime() {
     if (!this._realtime) this._realtime = new RealtimeService(this);
     return this._realtime;
   }
+  /**
+   * Service Edge Functions : invocation, et gestion des jobs et du cron avec une clé `service_role`.
+   */
   get functions() {
     if (!this._functions) this._functions = new FunctionsService(this);
     return this._functions;
   }
+  /** Service IA : conversation (`chat`), embeddings, RAG (ingestion, requêtes, espaces de noms), recherche sémantique et sessions. */
   get ai() {
     if (!this._ai) this._ai = new AiService(this);
     return this._ai;
   }
+  /**
+   * Service de notifications : envoi (e-mail, SMS, push, webhook), historique, modèles et administration. Exige une clé `service_role`.
+   */
   get notifications() {
     if (!this._notifications) this._notifications = new NotificationsService(this);
     return this._notifications;
@@ -229,7 +277,7 @@ function createServerClient(baseUrl, apiKey, options) {
   const defaultCookieOpts = {
     path: "/",
     secure: baseUrl.startsWith("https://"),
-    sameSite: "Lax",
+    sameSite: "lax",
     httpOnly: true,
     maxAge: 60 * 60 * 24 * 30,
     // 30 days

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/aurabase-js",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Official JavaScript/TypeScript client for Aurabase BaaS",
   "type": "module",
   "main": "dist/index.cjs",
@@ -61,12 +61,12 @@
   "author": "Aurabase",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/daylami555/aurabase.git",
+    "url": "git+https://github.com/Aurabase-cloud/Aurabase.git",
     "directory": "aurabase-js/packages/aurabase"
   },
   "homepage": "https://aurabase.cloud",
   "bugs": {
-    "url": "https://github.com/daylami555/aurabase/issues"
+    "url": "https://github.com/Aurabase-cloud/Aurabase/issues"
   },
   "keywords": [
     "aurabase",
@@ -76,14 +76,14 @@
     "client"
   ],
   "dependencies": {
-    "@aurabase/core": "0.6.0",
-    "@aurabase/storage": "0.6.0",
-    "@aurabase/db": "0.6.0",
-    "@aurabase/auth": "0.6.0",
-    "@aurabase/functions": "0.6.0",
-    "@aurabase/ai": "0.6.0",
-    "@aurabase/notifications": "0.6.0",
-    "@aurabase/realtime": "0.6.0"
+    "@aurabase/core": "0.6.2",
+    "@aurabase/auth": "0.6.2",
+    "@aurabase/db": "0.6.2",
+    "@aurabase/storage": "0.6.2",
+    "@aurabase/realtime": "0.6.2",
+    "@aurabase/functions": "0.6.2",
+    "@aurabase/ai": "0.6.2",
+    "@aurabase/notifications": "0.6.2"
   },
   "devDependencies": {
     "@types/node": "20.14.15",