@aurabase/aurabase-js 0.4.1 → 0.5.1

package/README.md

@@ -1,10 +1,12 @@
-# aurabase
+# @aurabase/aurabase-js
 
-Client JavaScript/TypeScript officiel d'Aurabase : point d'entrée principal du SDK, agrégeant les 8 packages de service (`@aurabase/*`) derrière `createClient`/`createAdminClient` et l'export `aurabase/ssr`.
+Client JavaScript/TypeScript officiel pour [Aurabase](https://aurabase.cloud) : la plateforme Backend-as-a-Service open-source haute performance propulsée par Rust.
 
-![npm](https://img.shields.io/npm/v/aurabase) ![license](https://img.shields.io/badge/license-MIT-blue)
+[![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)
 
-> Pre-release — pas encore publié sur npm.
+🌐 **Site officiel** : [https://aurabase.cloud](https://aurabase.cloud)  
+📖 **Documentation** : [https://aurabase.cloud/docs](https://aurabase.cloud)  
+🐙 **GitHub** : [daylami555/aurabase](https://github.com/daylami555/aurabase)
 
 ## Installation
 
@@ -16,8 +18,8 @@ npm i @aurabase/aurabase-js
 
 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.
 
-- `createClient(baseUrl, projectId, apiKey, options?)` — client applicatif standard.
-- `createAdminClient(baseUrl, projectId, serviceRoleKey, options?)` — client serveur avec `authAdmin` (clé `service_role`, jamais côté navigateur).
+- `createClient(projectUrl, apiKey, options?)` — client applicatif standard. **L'URL est le projet** : chaque projet est servi sur son propre sous-domaine (`https://<slug>.aurabase.cloud`) et la passerelle injecte elle-même le `project_id` dans le chemin. Aucun identifiant de projet dans le code client.
+- `createAdminClient(projectUrl, serviceRoleKey, options?)` — client serveur avec `authAdmin` (clé `service_role`, jamais côté navigateur).
 - `aurabase/ssr` — `createServerClient`/`createBrowserClient` pour Next.js et frameworks SSR (cookies, session partagée serveur/navigateur).
 
 ## Quick Start
@@ -25,11 +27,7 @@ Ce package ne réimplémente aucune logique de service : il compose `AuthService
 ```ts
 import { createClient } from '@aurabase/aurabase-js'
 
-const aura = createClient(
-  'http://localhost:8080',
-  '00000000-0000-0000-0000-000000000001',
-  'aura_anon_xxx',
-)
+const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx')
 
 const { data, error } = await aura.db
   .from('posts')

package/dist/{AuraClient-BcFE8u1v.d.cts → AuraClient-DL7mqfNu.d.cts}

@@ -1,25 +1,31 @@
-import { AuraClientLike, BaseAuthStore, AuraObservabilityEvent, AuraClientOptions, ChannelConfig } from '@aurabase/core';
+import { AiService } from '@aurabase/ai';
 import { AuthService, AuthAdminService } from '@aurabase/auth';
+import { AuraClientLike, BaseAuthStore, AuraObservabilityEvent, AuraClientOptions, ChannelConfig } from '@aurabase/core';
 import { DatabaseService } from '@aurabase/db';
-import { StorageService } from '@aurabase/storage';
-import { RealtimeService, AuraChannel } from '@aurabase/realtime';
 import { FunctionsService } from '@aurabase/functions';
-import { AiService } from '@aurabase/ai';
 import { NotificationsService } from '@aurabase/notifications';
+import { RealtimeService, AuraChannel } from '@aurabase/realtime';
+import { StorageService } from '@aurabase/storage';
 
 /**
  * Main Aurabase client.
  *
+ * L'URL EST le projet : chaque projet est servi sur son propre sous-domaine
+ * (`https://<slug>.aurabase.cloud`), et la passerelle résout le tenant depuis l'hôte puis
+ * injecte le `project_id` dans le chemin (`inject_project_id`,
+ * `services/aura-gateway/src/middleware/project_subdomain.rs`). Aucun identifiant de projet
+ * n'est donc écrit ni transporté par le client.
+ *
  * @example
  * ```ts
  * import { createClient } from '@aurabase/aurabase-js'
- * const aura = createClient('http://localhost:8080', 'my-project-id')
+ * const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx')
  * const { data } = await aura.db.from('posts').eq('published', true)
  * ```
  */
 declare class AuraClient<Database = any> implements AuraClientLike {
+    /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
     readonly baseUrl: string;
-    readonly projectId: string;
     readonly apiKey: string | null;
     readonly fetchFn: typeof globalThis.fetch;
     readonly authStore: BaseAuthStore;
@@ -45,7 +51,11 @@ declare class AuraClient<Database = any> implements AuraClientLike {
     private readonly _persistSession;
     private readonly _autoRefresh;
     private readonly _detectSessionInUrl;
-    constructor(baseUrl: string, projectId: string, apiKeyOrOptions?: string | AuraClientOptions, options?: AuraClientOptions);
+    /**
+     * @param baseUrl URL du projet (`https://<slug>.aurabase.cloud`).
+     * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
+     */
+    constructor(baseUrl: string, apiKey: string, options?: AuraClientOptions);
     /**
      * Démonte le client : arrête le refresh proactif (ticker + visibilité + BroadcastChannel),
      * déconnecte le realtime, vide les listeners d'auth. Idempotent. À appeler en teardown
@@ -72,6 +82,21 @@ declare class AuraClient<Database = any> implements AuraClientLike {
      * ```
      */
     channel(name: string, options?: ChannelConfig): AuraChannel;
+    /**
+     * Shortcut: remove a realtime channel by name or AuraChannel instance.
+     * Equivalent to `aura.realtime.removeChannel(channel)`.
+     */
+    removeChannel(channel: string | AuraChannel): void;
+    /**
+     * Shortcut: remove all realtime channels and unsubscribe.
+     * Equivalent to `aura.realtime.removeAllChannels()`.
+     */
+    removeAllChannels(): void;
+    /**
+     * Shortcut: list all active realtime channels.
+     * Equivalent to `aura.realtime.getChannels()`.
+     */
+    getChannels(): AuraChannel[];
 }
 
 export { AuraClient as A };

package/dist/{AuraClient-BcFE8u1v.d.ts → AuraClient-DL7mqfNu.d.ts}

@@ -1,25 +1,31 @@
-import { AuraClientLike, BaseAuthStore, AuraObservabilityEvent, AuraClientOptions, ChannelConfig } from '@aurabase/core';
+import { AiService } from '@aurabase/ai';
 import { AuthService, AuthAdminService } from '@aurabase/auth';
+import { AuraClientLike, BaseAuthStore, AuraObservabilityEvent, AuraClientOptions, ChannelConfig } from '@aurabase/core';
 import { DatabaseService } from '@aurabase/db';
-import { StorageService } from '@aurabase/storage';
-import { RealtimeService, AuraChannel } from '@aurabase/realtime';
 import { FunctionsService } from '@aurabase/functions';
-import { AiService } from '@aurabase/ai';
 import { NotificationsService } from '@aurabase/notifications';
+import { RealtimeService, AuraChannel } from '@aurabase/realtime';
+import { StorageService } from '@aurabase/storage';
 
 /**
  * Main Aurabase client.
  *
+ * L'URL EST le projet : chaque projet est servi sur son propre sous-domaine
+ * (`https://<slug>.aurabase.cloud`), et la passerelle résout le tenant depuis l'hôte puis
+ * injecte le `project_id` dans le chemin (`inject_project_id`,
+ * `services/aura-gateway/src/middleware/project_subdomain.rs`). Aucun identifiant de projet
+ * n'est donc écrit ni transporté par le client.
+ *
  * @example
  * ```ts
  * import { createClient } from '@aurabase/aurabase-js'
- * const aura = createClient('http://localhost:8080', 'my-project-id')
+ * const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx')
  * const { data } = await aura.db.from('posts').eq('published', true)
  * ```
  */
 declare class AuraClient<Database = any> implements AuraClientLike {
+    /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
     readonly baseUrl: string;
-    readonly projectId: string;
     readonly apiKey: string | null;
     readonly fetchFn: typeof globalThis.fetch;
     readonly authStore: BaseAuthStore;
@@ -45,7 +51,11 @@ declare class AuraClient<Database = any> implements AuraClientLike {
     private readonly _persistSession;
     private readonly _autoRefresh;
     private readonly _detectSessionInUrl;
-    constructor(baseUrl: string, projectId: string, apiKeyOrOptions?: string | AuraClientOptions, options?: AuraClientOptions);
+    /**
+     * @param baseUrl URL du projet (`https://<slug>.aurabase.cloud`).
+     * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
+     */
+    constructor(baseUrl: string, apiKey: string, options?: AuraClientOptions);
     /**
      * Démonte le client : arrête le refresh proactif (ticker + visibilité + BroadcastChannel),
      * déconnecte le realtime, vide les listeners d'auth. Idempotent. À appeler en teardown
@@ -72,6 +82,21 @@ declare class AuraClient<Database = any> implements AuraClientLike {
      * ```
      */
     channel(name: string, options?: ChannelConfig): AuraChannel;
+    /**
+     * Shortcut: remove a realtime channel by name or AuraChannel instance.
+     * Equivalent to `aura.realtime.removeChannel(channel)`.
+     */
+    removeChannel(channel: string | AuraChannel): void;
+    /**
+     * Shortcut: remove all realtime channels and unsubscribe.
+     * Equivalent to `aura.realtime.removeAllChannels()`.
+     */
+    removeAllChannels(): void;
+    /**
+     * Shortcut: list all active realtime channels.
+     * Equivalent to `aura.realtime.getChannels()`.
+     */
+    getChannels(): AuraChannel[];
 }
 
 export { AuraClient as A };

package/dist/index.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
-var core = require('@aurabase/core');
+var ai = require('@aurabase/ai');
 var auth = require('@aurabase/auth');
+var core = require('@aurabase/core');
 var db = require('@aurabase/db');
-var storage = require('@aurabase/storage');
-var realtime = require('@aurabase/realtime');
 var functions = require('@aurabase/functions');
-var ai = require('@aurabase/ai');
 var notifications = require('@aurabase/notifications');
+var realtime = require('@aurabase/realtime');
+var storage = require('@aurabase/storage');
 
-// src/AuraClient.ts
+// src/index.ts
 function isBrowserContext() {
   if (typeof window !== "undefined") return true;
   const g = globalThis;
@@ -19,8 +19,8 @@ function isBrowserContext() {
 }
 var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
+  /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
-  projectId;
   apiKey;
   fetchFn;
   authStore;
@@ -44,11 +44,14 @@ var AuraClient = class {
   _persistSession;
   _autoRefresh;
   _detectSessionInUrl;
-  constructor(baseUrl, projectId, apiKeyOrOptions, options) {
+  /**
+   * @param baseUrl URL du projet (`https://<slug>.aurabase.cloud`).
+   * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
+   */
+  constructor(baseUrl, apiKey, options) {
     this.baseUrl = baseUrl.replace(/\/+$/, "");
-    this.projectId = projectId;
-    const resolvedOptions = typeof apiKeyOrOptions === "string" ? options : apiKeyOrOptions;
-    this.apiKey = typeof apiKeyOrOptions === "string" ? apiKeyOrOptions : apiKeyOrOptions?.apiKey ?? null;
+    const resolvedOptions = options;
+    this.apiKey = apiKey || null;
     this.fetchFn = resolvedOptions?.fetch ?? globalThis.fetch.bind(globalThis);
     const r = resolvedOptions?.retry;
     this.retryConfig = r === false ? { enabled: false, maxRetries: 0 } : r === void 0 || r === true ? { enabled: true, maxRetries: core.DEFAULT_MAX_RETRIES } : { enabled: r.enabled ?? true, maxRetries: r.maxRetries ?? core.DEFAULT_MAX_RETRIES };
@@ -74,7 +77,7 @@ var AuraClient = class {
     } else if (resolvedOptions?.auth?.persistSession === false) {
       this.authStore = new core.BaseAuthStore();
     } else if (typeof localStorage !== "undefined") {
-      this.authStore = new core.LocalAuthStore();
+      this.authStore = new core.LocalAuthStore(`aura-${core.clientScope(this.baseUrl)}-auth`);
     } else {
       this.authStore = new core.BaseAuthStore();
     }
@@ -105,6 +108,15 @@ var AuraClient = class {
         persistSession: this._persistSession,
         detectSessionInUrl: this._detectSessionInUrl
       });
+      this._auth.onAuthStateChange(({ event, accessToken }) => {
+        if (this._realtime) {
+          if (accessToken) {
+            this._realtime.setAuth(accessToken);
+          } else if (event === "SIGNED_OUT") {
+            this._realtime.setAuth("");
+          }
+        }
+      });
     }
     return this._auth;
   }
@@ -155,34 +167,45 @@ var AuraClient = class {
   channel(name, options) {
     return this.realtime.channel(name, options);
   }
+  /**
+   * Shortcut: remove a realtime channel by name or AuraChannel instance.
+   * Equivalent to `aura.realtime.removeChannel(channel)`.
+   */
+  removeChannel(channel) {
+    return this.realtime.removeChannel(channel);
+  }
+  /**
+   * Shortcut: remove all realtime channels and unsubscribe.
+   * Equivalent to `aura.realtime.removeAllChannels()`.
+   */
+  removeAllChannels() {
+    return this.realtime.removeAllChannels();
+  }
+  /**
+   * Shortcut: list all active realtime channels.
+   * Equivalent to `aura.realtime.getChannels()`.
+   */
+  getChannels() {
+    return this.realtime.getChannels();
+  }
 };
-function createClient(baseUrl, projectId, apiKeyOrOptions, options) {
-  return new AuraClient(baseUrl, projectId, apiKeyOrOptions, options);
+
+// src/index.ts
+function createClient(baseUrl, apiKey, options) {
+  return new AuraClient(baseUrl, apiKey, options);
 }
-function createAdminClient(baseUrl, projectId, serviceRoleKey, options) {
+function createAdminClient(baseUrl, serviceRoleKey, options) {
   if (isBrowserContext()) {
     throw new Error(
       "[aurabase] createAdminClient() ne doit jamais \xEAtre appel\xE9 c\xF4t\xE9 navigateur : la cl\xE9 service_role serait expos\xE9e dans le bundle. \xC0 utiliser uniquement c\xF4t\xE9 serveur."
     );
   }
-  return new AuraClient(baseUrl, projectId, serviceRoleKey, options);
+  return new AuraClient(baseUrl, serviceRoleKey, options);
 }
 
-Object.defineProperty(exports, "AuraError", {
-  enumerable: true,
-  get: function () { return core.AuraError; }
-});
-Object.defineProperty(exports, "BaseAuthStore", {
-  enumerable: true,
-  get: function () { return core.BaseAuthStore; }
-});
-Object.defineProperty(exports, "LocalAuthStore", {
-  enumerable: true,
-  get: function () { return core.LocalAuthStore; }
-});
-Object.defineProperty(exports, "isAuraError", {
+Object.defineProperty(exports, "AiService", {
   enumerable: true,
-  get: function () { return core.isAuraError; }
+  get: function () { return ai.AiService; }
 });
 Object.defineProperty(exports, "AuthAdminService", {
   enumerable: true,
@@ -196,33 +219,33 @@ Object.defineProperty(exports, "isMfaChallenge", {
   enumerable: true,
   get: function () { return auth.isMfaChallenge; }
 });
-Object.defineProperty(exports, "DatabaseService", {
+Object.defineProperty(exports, "AuraError", {
   enumerable: true,
-  get: function () { return db.DatabaseService; }
+  get: function () { return core.AuraError; }
 });
-Object.defineProperty(exports, "QueryBuilder", {
+Object.defineProperty(exports, "BaseAuthStore", {
   enumerable: true,
-  get: function () { return db.QueryBuilder; }
+  get: function () { return core.BaseAuthStore; }
 });
-Object.defineProperty(exports, "StorageService", {
+Object.defineProperty(exports, "LocalAuthStore", {
   enumerable: true,
-  get: function () { return storage.StorageService; }
+  get: function () { return core.LocalAuthStore; }
 });
-Object.defineProperty(exports, "AuraChannel", {
+Object.defineProperty(exports, "isAuraError", {
   enumerable: true,
-  get: function () { return realtime.AuraChannel; }
+  get: function () { return core.isAuraError; }
 });
-Object.defineProperty(exports, "RealtimeService", {
+Object.defineProperty(exports, "DatabaseService", {
   enumerable: true,
-  get: function () { return realtime.RealtimeService; }
+  get: function () { return db.DatabaseService; }
 });
-Object.defineProperty(exports, "FunctionsService", {
+Object.defineProperty(exports, "QueryBuilder", {
   enumerable: true,
-  get: function () { return functions.FunctionsService; }
+  get: function () { return db.QueryBuilder; }
 });
-Object.defineProperty(exports, "AiService", {
+Object.defineProperty(exports, "FunctionsService", {
   enumerable: true,
-  get: function () { return ai.AiService; }
+  get: function () { return functions.FunctionsService; }
 });
 Object.defineProperty(exports, "NotificationsAdminService", {
   enumerable: true,
@@ -232,6 +255,18 @@ Object.defineProperty(exports, "NotificationsService", {
   enumerable: true,
   get: function () { return notifications.NotificationsService; }
 });
+Object.defineProperty(exports, "AuraChannel", {
+  enumerable: true,
+  get: function () { return realtime.AuraChannel; }
+});
+Object.defineProperty(exports, "RealtimeService", {
+  enumerable: true,
+  get: function () { return realtime.RealtimeService; }
+});
+Object.defineProperty(exports, "StorageService", {
+  enumerable: true,
+  get: function () { return storage.StorageService; }
+});
 exports.AuraClient = AuraClient;
 exports.createAdminClient = createAdminClient;
 exports.createClient = createClient;

package/dist/index.d.cts

@@ -1,32 +1,33 @@
-import { A as AuraClient } from './AuraClient-BcFE8u1v.cjs';
+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, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, ChannelConfig, ChatMessage, ChatResponse, CountMode, 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, OAuthSignInOptions, PasswordResetRequest, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, 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, 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 { AuthAdminService, AuthService, isMfaChallenge } from '@aurabase/auth';
-export { StorageService } from '@aurabase/storage';
-export { AuraChannel, RealtimeService } from '@aurabase/realtime';
 export { FunctionsService } from '@aurabase/functions';
-export { AiService } from '@aurabase/ai';
 export { NotificationsAdminService, NotificationsService } from '@aurabase/notifications';
+export { AuraChannel, RealtimeService } from '@aurabase/realtime';
+export { StorageService } from '@aurabase/storage';
+import { A as AuraClient } from './AuraClient-DL7mqfNu.cjs';
 
 /**
  * Create a new Aurabase client instance.
  *
+ * **L'URL est le projet.** Chaque projet est servi sur son propre sous-domaine
+ * (`https://<slug>.aurabase.cloud`) : la passerelle résout le tenant depuis l'hôte et
+ * injecte elle-même le `project_id` dans le chemin. Aucun identifiant de projet ne figure
+ * donc dans le code client — l'URL de connexion du projet suffit, avec sa clé.
+ *
  * @example
  * ```ts
- * // With API key (recommended — like Supabase)
- * const aura = createClient('http://localhost:8080', 'project-uuid', 'aura_anon_xxx')
+ * const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx')
  *
- * // With options
- * const aura = createClient('http://localhost:8080', 'project-uuid', 'aura_anon_xxx', {
+ * // Avec options
+ * const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx', {
  *   auth: { persistSession: true }
  * })
- *
- * // Without API key (backward compatible)
- * const aura = createClient('http://localhost:8080', 'project-uuid')
  * ```
  */
-declare function createClient<Database = any>(baseUrl: string, projectId: string, apiKeyOrOptions?: string | AuraClientOptions, options?: AuraClientOptions): AuraClient<Database>;
+declare function createClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database>;
 /**
  * Crée un client à usage **SERVEUR uniquement** pour les opérations d'administration
  * (`client.authAdmin` : lister/créer/bannir des utilisateurs, lire l'audit). Exige une
@@ -37,10 +38,10 @@ declare function createClient<Database = any>(baseUrl: string, projectId: string
  * @example
  * ```ts
  * // server-side only (API route, edge function, backend)
- * const admin = createAdminClient(url, projectId, process.env.SERVICE_ROLE_KEY!)
+ * const admin = createAdminClient(projectUrl, process.env.SERVICE_ROLE_KEY!)
  * await admin.authAdmin.listUsers()
  * ```
  */
-declare function createAdminClient<Database = any>(baseUrl: string, projectId: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database>;
+declare function createAdminClient<Database = any>(baseUrl: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database>;
 
 export { AuraClient, createAdminClient, createClient };

package/dist/index.d.ts

@@ -1,32 +1,33 @@
-import { A as AuraClient } from './AuraClient-BcFE8u1v.js';
+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, BaseAuthStore, BatchSendResponse, BroadcastFilter, BroadcastPayload, ChannelConfig, ChatMessage, ChatResponse, CountMode, 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, OAuthSignInOptions, PasswordResetRequest, PostgresChangesFilter, PresenceFilter, PresenceInfo, PresenceState, QueryFilter, QueryOptions, RagIngestRequest, RagIngestResponse, RagRequest, RagResponse, RealtimeEvent, RealtimeListenType, RealtimeSubscribeStatus, SchemaColumn, 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, 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 { AuthAdminService, AuthService, isMfaChallenge } from '@aurabase/auth';
-export { StorageService } from '@aurabase/storage';
-export { AuraChannel, RealtimeService } from '@aurabase/realtime';
 export { FunctionsService } from '@aurabase/functions';
-export { AiService } from '@aurabase/ai';
 export { NotificationsAdminService, NotificationsService } from '@aurabase/notifications';
+export { AuraChannel, RealtimeService } from '@aurabase/realtime';
+export { StorageService } from '@aurabase/storage';
+import { A as AuraClient } from './AuraClient-DL7mqfNu.js';
 
 /**
  * Create a new Aurabase client instance.
  *
+ * **L'URL est le projet.** Chaque projet est servi sur son propre sous-domaine
+ * (`https://<slug>.aurabase.cloud`) : la passerelle résout le tenant depuis l'hôte et
+ * injecte elle-même le `project_id` dans le chemin. Aucun identifiant de projet ne figure
+ * donc dans le code client — l'URL de connexion du projet suffit, avec sa clé.
+ *
  * @example
  * ```ts
- * // With API key (recommended — like Supabase)
- * const aura = createClient('http://localhost:8080', 'project-uuid', 'aura_anon_xxx')
+ * const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx')
  *
- * // With options
- * const aura = createClient('http://localhost:8080', 'project-uuid', 'aura_anon_xxx', {
+ * // Avec options
+ * const aura = createClient('https://mon-projet.aurabase.cloud', 'aura_anon_xxx', {
  *   auth: { persistSession: true }
  * })
- *
- * // Without API key (backward compatible)
- * const aura = createClient('http://localhost:8080', 'project-uuid')
  * ```
  */
-declare function createClient<Database = any>(baseUrl: string, projectId: string, apiKeyOrOptions?: string | AuraClientOptions, options?: AuraClientOptions): AuraClient<Database>;
+declare function createClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database>;
 /**
  * Crée un client à usage **SERVEUR uniquement** pour les opérations d'administration
  * (`client.authAdmin` : lister/créer/bannir des utilisateurs, lire l'audit). Exige une
@@ -37,10 +38,10 @@ declare function createClient<Database = any>(baseUrl: string, projectId: string
  * @example
  * ```ts
  * // server-side only (API route, edge function, backend)
- * const admin = createAdminClient(url, projectId, process.env.SERVICE_ROLE_KEY!)
+ * const admin = createAdminClient(projectUrl, process.env.SERVICE_ROLE_KEY!)
  * await admin.authAdmin.listUsers()
  * ```
  */
-declare function createAdminClient<Database = any>(baseUrl: string, projectId: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database>;
+declare function createAdminClient<Database = any>(baseUrl: string, serviceRoleKey: string, options?: AuraClientOptions): AuraClient<Database>;
 
 export { AuraClient, createAdminClient, createClient };

package/dist/index.js

@@ -1,21 +1,21 @@
-import { DEFAULT_MAX_RETRIES, BaseAuthStore, LocalAuthStore } from '@aurabase/core';
-export { AuraError, BaseAuthStore, LocalAuthStore, isAuraError } from '@aurabase/core';
+import { AiService } from '@aurabase/ai';
+export { AiService } from '@aurabase/ai';
 import { AuthService, AuthAdminService } from '@aurabase/auth';
 export { AuthAdminService, AuthService, isMfaChallenge } from '@aurabase/auth';
+import { DEFAULT_MAX_RETRIES, BaseAuthStore, LocalAuthStore, clientScope } from '@aurabase/core';
+export { AuraError, BaseAuthStore, LocalAuthStore, isAuraError } from '@aurabase/core';
 import { DatabaseService } from '@aurabase/db';
 export { DatabaseService, QueryBuilder } from '@aurabase/db';
-import { StorageService } from '@aurabase/storage';
-export { StorageService } from '@aurabase/storage';
-import { RealtimeService } from '@aurabase/realtime';
-export { AuraChannel, RealtimeService } from '@aurabase/realtime';
 import { FunctionsService } from '@aurabase/functions';
 export { FunctionsService } from '@aurabase/functions';
-import { AiService } from '@aurabase/ai';
-export { AiService } from '@aurabase/ai';
 import { NotificationsService } from '@aurabase/notifications';
 export { NotificationsAdminService, NotificationsService } from '@aurabase/notifications';
+import { RealtimeService } from '@aurabase/realtime';
+export { AuraChannel, RealtimeService } from '@aurabase/realtime';
+import { StorageService } from '@aurabase/storage';
+export { StorageService } from '@aurabase/storage';
 
-// src/AuraClient.ts
+// src/index.ts
 function isBrowserContext() {
   if (typeof window !== "undefined") return true;
   const g = globalThis;
@@ -25,8 +25,8 @@ function isBrowserContext() {
 }
 var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
+  /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
-  projectId;
   apiKey;
   fetchFn;
   authStore;
@@ -50,11 +50,14 @@ var AuraClient = class {
   _persistSession;
   _autoRefresh;
   _detectSessionInUrl;
-  constructor(baseUrl, projectId, apiKeyOrOptions, options) {
+  /**
+   * @param baseUrl URL du projet (`https://<slug>.aurabase.cloud`).
+   * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
+   */
+  constructor(baseUrl, apiKey, options) {
     this.baseUrl = baseUrl.replace(/\/+$/, "");
-    this.projectId = projectId;
-    const resolvedOptions = typeof apiKeyOrOptions === "string" ? options : apiKeyOrOptions;
-    this.apiKey = typeof apiKeyOrOptions === "string" ? apiKeyOrOptions : apiKeyOrOptions?.apiKey ?? null;
+    const resolvedOptions = options;
+    this.apiKey = apiKey || null;
     this.fetchFn = resolvedOptions?.fetch ?? globalThis.fetch.bind(globalThis);
     const r = resolvedOptions?.retry;
     this.retryConfig = r === false ? { enabled: false, maxRetries: 0 } : r === void 0 || r === true ? { enabled: true, maxRetries: DEFAULT_MAX_RETRIES } : { enabled: r.enabled ?? true, maxRetries: r.maxRetries ?? DEFAULT_MAX_RETRIES };
@@ -80,7 +83,7 @@ var AuraClient = class {
     } else if (resolvedOptions?.auth?.persistSession === false) {
       this.authStore = new BaseAuthStore();
     } else if (typeof localStorage !== "undefined") {
-      this.authStore = new LocalAuthStore();
+      this.authStore = new LocalAuthStore(`aura-${clientScope(this.baseUrl)}-auth`);
     } else {
       this.authStore = new BaseAuthStore();
     }
@@ -111,6 +114,15 @@ var AuraClient = class {
         persistSession: this._persistSession,
         detectSessionInUrl: this._detectSessionInUrl
       });
+      this._auth.onAuthStateChange(({ event, accessToken }) => {
+        if (this._realtime) {
+          if (accessToken) {
+            this._realtime.setAuth(accessToken);
+          } else if (event === "SIGNED_OUT") {
+            this._realtime.setAuth("");
+          }
+        }
+      });
     }
     return this._auth;
   }
@@ -161,17 +173,40 @@ var AuraClient = class {
   channel(name, options) {
     return this.realtime.channel(name, options);
   }
+  /**
+   * Shortcut: remove a realtime channel by name or AuraChannel instance.
+   * Equivalent to `aura.realtime.removeChannel(channel)`.
+   */
+  removeChannel(channel) {
+    return this.realtime.removeChannel(channel);
+  }
+  /**
+   * Shortcut: remove all realtime channels and unsubscribe.
+   * Equivalent to `aura.realtime.removeAllChannels()`.
+   */
+  removeAllChannels() {
+    return this.realtime.removeAllChannels();
+  }
+  /**
+   * Shortcut: list all active realtime channels.
+   * Equivalent to `aura.realtime.getChannels()`.
+   */
+  getChannels() {
+    return this.realtime.getChannels();
+  }
 };
-function createClient(baseUrl, projectId, apiKeyOrOptions, options) {
-  return new AuraClient(baseUrl, projectId, apiKeyOrOptions, options);
+
+// src/index.ts
+function createClient(baseUrl, apiKey, options) {
+  return new AuraClient(baseUrl, apiKey, options);
 }
-function createAdminClient(baseUrl, projectId, serviceRoleKey, options) {
+function createAdminClient(baseUrl, serviceRoleKey, options) {
   if (isBrowserContext()) {
     throw new Error(
       "[aurabase] createAdminClient() ne doit jamais \xEAtre appel\xE9 c\xF4t\xE9 navigateur : la cl\xE9 service_role serait expos\xE9e dans le bundle. \xC0 utiliser uniquement c\xF4t\xE9 serveur."
     );
   }
-  return new AuraClient(baseUrl, projectId, serviceRoleKey, options);
+  return new AuraClient(baseUrl, serviceRoleKey, options);
 }
 
 export { AuraClient, createAdminClient, createClient };

package/dist/ssr.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
 var core = require('@aurabase/core');
+var ai = require('@aurabase/ai');
 var auth = require('@aurabase/auth');
 var db = require('@aurabase/db');
-var storage = require('@aurabase/storage');
-var realtime = require('@aurabase/realtime');
 var functions = require('@aurabase/functions');
-var ai = require('@aurabase/ai');
 var notifications = require('@aurabase/notifications');
+var realtime = require('@aurabase/realtime');
+var storage = require('@aurabase/storage');
 
-// src/AuraClient.ts
+// src/ssr.ts
 function isBrowserContext() {
   if (typeof window !== "undefined") return true;
   const g = globalThis;
@@ -19,8 +19,8 @@ function isBrowserContext() {
 }
 var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
+  /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
-  projectId;
   apiKey;
   fetchFn;
   authStore;
@@ -44,11 +44,14 @@ var AuraClient = class {
   _persistSession;
   _autoRefresh;
   _detectSessionInUrl;
-  constructor(baseUrl, projectId, apiKeyOrOptions, options) {
+  /**
+   * @param baseUrl URL du projet (`https://<slug>.aurabase.cloud`).
+   * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
+   */
+  constructor(baseUrl, apiKey, options) {
     this.baseUrl = baseUrl.replace(/\/+$/, "");
-    this.projectId = projectId;
-    const resolvedOptions = typeof apiKeyOrOptions === "string" ? options : apiKeyOrOptions;
-    this.apiKey = typeof apiKeyOrOptions === "string" ? apiKeyOrOptions : apiKeyOrOptions?.apiKey ?? null;
+    const resolvedOptions = options;
+    this.apiKey = apiKey || null;
     this.fetchFn = resolvedOptions?.fetch ?? globalThis.fetch.bind(globalThis);
     const r = resolvedOptions?.retry;
     this.retryConfig = r === false ? { enabled: false, maxRetries: 0 } : r === void 0 || r === true ? { enabled: true, maxRetries: core.DEFAULT_MAX_RETRIES } : { enabled: r.enabled ?? true, maxRetries: r.maxRetries ?? core.DEFAULT_MAX_RETRIES };
@@ -74,7 +77,7 @@ var AuraClient = class {
     } else if (resolvedOptions?.auth?.persistSession === false) {
       this.authStore = new core.BaseAuthStore();
     } else if (typeof localStorage !== "undefined") {
-      this.authStore = new core.LocalAuthStore();
+      this.authStore = new core.LocalAuthStore(`aura-${core.clientScope(this.baseUrl)}-auth`);
     } else {
       this.authStore = new core.BaseAuthStore();
     }
@@ -105,6 +108,15 @@ var AuraClient = class {
         persistSession: this._persistSession,
         detectSessionInUrl: this._detectSessionInUrl
       });
+      this._auth.onAuthStateChange(({ event, accessToken }) => {
+        if (this._realtime) {
+          if (accessToken) {
+            this._realtime.setAuth(accessToken);
+          } else if (event === "SIGNED_OUT") {
+            this._realtime.setAuth("");
+          }
+        }
+      });
     }
     return this._auth;
   }
@@ -155,10 +167,31 @@ var AuraClient = class {
   channel(name, options) {
     return this.realtime.channel(name, options);
   }
+  /**
+   * Shortcut: remove a realtime channel by name or AuraChannel instance.
+   * Equivalent to `aura.realtime.removeChannel(channel)`.
+   */
+  removeChannel(channel) {
+    return this.realtime.removeChannel(channel);
+  }
+  /**
+   * Shortcut: remove all realtime channels and unsubscribe.
+   * Equivalent to `aura.realtime.removeAllChannels()`.
+   */
+  removeAllChannels() {
+    return this.realtime.removeAllChannels();
+  }
+  /**
+   * Shortcut: list all active realtime channels.
+   * Equivalent to `aura.realtime.getChannels()`.
+   */
+  getChannels() {
+    return this.realtime.getChannels();
+  }
 };
 var MAX_CHUNK_SIZE = 3600;
-function createServerClient(baseUrl, projectId, options) {
-  const cookieName = `aura-${projectId}-auth`;
+function createServerClient(baseUrl, apiKey, options) {
+  const cookieName = `aura-${core.clientScope(baseUrl)}-auth`;
   const store = new core.LocalAuthStore(cookieName);
   const idxRe = new RegExp(`^${cookieName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\.(\\d+)$`);
   const incoming = options.cookies.getAll();
@@ -193,7 +226,11 @@ function createServerClient(baseUrl, projectId, options) {
         let idx = 0;
         for (let i = 0; i < decoded.length; i += MAX_CHUNK_SIZE, idx++) {
           const name = `${cookieName}.${idx}`;
-          toSet.push({ name, value: decoded.slice(i, i + MAX_CHUNK_SIZE), options: defaultCookieOpts });
+          toSet.push({
+            name,
+            value: decoded.slice(i, i + MAX_CHUNK_SIZE),
+            options: defaultCookieOpts
+          });
           used.add(name);
         }
       }
@@ -204,12 +241,12 @@ function createServerClient(baseUrl, projectId, options) {
     }
     if (toSet.length > 0) options.cookies.setAll(toSet);
   });
-  return new AuraClient(baseUrl, projectId, options.apiKey, {
+  return new AuraClient(baseUrl, apiKey, {
     auth: { persistSession: false, storage: store }
   });
 }
-function createBrowserClient(baseUrl, projectId, apiKey, options) {
-  return new AuraClient(baseUrl, projectId, apiKey, options);
+function createBrowserClient(baseUrl, apiKey, options) {
+  return new AuraClient(baseUrl, apiKey, options);
 }
 
 Object.defineProperty(exports, "parseCookieHeader", {

package/dist/ssr.d.cts

@@ -1,13 +1,13 @@
-import { A as AuraClient } from './AuraClient-BcFE8u1v.cjs';
 import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
 export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
+import { A as AuraClient } from './AuraClient-DL7mqfNu.cjs';
+import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';
-import '@aurabase/storage';
-import '@aurabase/realtime';
 import '@aurabase/functions';
-import '@aurabase/ai';
 import '@aurabase/notifications';
+import '@aurabase/realtime';
+import '@aurabase/storage';
 
 /**
  * Server-side rendering helpers for Aurabase.
@@ -18,7 +18,7 @@ import '@aurabase/notifications';
  *
  * export async function middleware(request) {
  *   let response = NextResponse.next({ request })
- *   const client = createServerClient(URL, PROJECT_ID, {
+ *   const client = createServerClient(PROJECT_URL, ANON_KEY, {
  *     cookies: {
  *       getAll: () => request.cookies.getAll(),
  *       setAll: (cookies) => {
@@ -51,15 +51,14 @@ interface CookieHandler {
     }>): void;
 }
 interface ServerClientOptions {
-    apiKey?: string;
     cookies: CookieHandler;
     cookieOptions?: SerializeCookieOptions;
 }
-declare function createServerClient<Database = any>(baseUrl: string, projectId: string, options: ServerClientOptions): AuraClient<Database>;
+declare function createServerClient<Database = any>(baseUrl: string, apiKey: string, options: ServerClientOptions): AuraClient<Database>;
 /**
  * Create an Aurabase client for browser usage.
  * Thin wrapper around AuraClient with sensible browser defaults.
  */
-declare function createBrowserClient<Database = any>(baseUrl: string, projectId: string, apiKey?: string, options?: AuraClientOptions): AuraClient<Database>;
+declare function createBrowserClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database>;
 
 export { type CookieHandler, type ServerClientOptions, createBrowserClient, createServerClient };

package/dist/ssr.d.ts

@@ -1,13 +1,13 @@
-import { A as AuraClient } from './AuraClient-BcFE8u1v.js';
 import { SerializeCookieOptions, AuraClientOptions } from '@aurabase/core';
 export { SerializeCookieOptions, parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
+import { A as AuraClient } from './AuraClient-DL7mqfNu.js';
+import '@aurabase/ai';
 import '@aurabase/auth';
 import '@aurabase/db';
-import '@aurabase/storage';
-import '@aurabase/realtime';
 import '@aurabase/functions';
-import '@aurabase/ai';
 import '@aurabase/notifications';
+import '@aurabase/realtime';
+import '@aurabase/storage';
 
 /**
  * Server-side rendering helpers for Aurabase.
@@ -18,7 +18,7 @@ import '@aurabase/notifications';
  *
  * export async function middleware(request) {
  *   let response = NextResponse.next({ request })
- *   const client = createServerClient(URL, PROJECT_ID, {
+ *   const client = createServerClient(PROJECT_URL, ANON_KEY, {
  *     cookies: {
  *       getAll: () => request.cookies.getAll(),
  *       setAll: (cookies) => {
@@ -51,15 +51,14 @@ interface CookieHandler {
     }>): void;
 }
 interface ServerClientOptions {
-    apiKey?: string;
     cookies: CookieHandler;
     cookieOptions?: SerializeCookieOptions;
 }
-declare function createServerClient<Database = any>(baseUrl: string, projectId: string, options: ServerClientOptions): AuraClient<Database>;
+declare function createServerClient<Database = any>(baseUrl: string, apiKey: string, options: ServerClientOptions): AuraClient<Database>;
 /**
  * Create an Aurabase client for browser usage.
  * Thin wrapper around AuraClient with sensible browser defaults.
  */
-declare function createBrowserClient<Database = any>(baseUrl: string, projectId: string, apiKey?: string, options?: AuraClientOptions): AuraClient<Database>;
+declare function createBrowserClient<Database = any>(baseUrl: string, apiKey: string, options?: AuraClientOptions): AuraClient<Database>;
 
 export { type CookieHandler, type ServerClientOptions, createBrowserClient, createServerClient };

package/dist/ssr.js

@@ -1,14 +1,14 @@
-import { LocalAuthStore, DEFAULT_MAX_RETRIES, BaseAuthStore } from '@aurabase/core';
+import { clientScope, LocalAuthStore, DEFAULT_MAX_RETRIES, BaseAuthStore } from '@aurabase/core';
 export { parseCookieHeader, serializeCookieHeader } from '@aurabase/core';
+import { AiService } from '@aurabase/ai';
 import { AuthService, AuthAdminService } from '@aurabase/auth';
 import { DatabaseService } from '@aurabase/db';
-import { StorageService } from '@aurabase/storage';
-import { RealtimeService } from '@aurabase/realtime';
 import { FunctionsService } from '@aurabase/functions';
-import { AiService } from '@aurabase/ai';
 import { NotificationsService } from '@aurabase/notifications';
+import { RealtimeService } from '@aurabase/realtime';
+import { StorageService } from '@aurabase/storage';
 
-// src/AuraClient.ts
+// src/ssr.ts
 function isBrowserContext() {
   if (typeof window !== "undefined") return true;
   const g = globalThis;
@@ -18,8 +18,8 @@ function isBrowserContext() {
 }
 var SERVICE_ROLE_KEY_PREFIX = "aura_sk_";
 var AuraClient = class {
+  /** URL du projet (`https://<slug>.aurabase.cloud`), sans barre finale. */
   baseUrl;
-  projectId;
   apiKey;
   fetchFn;
   authStore;
@@ -43,11 +43,14 @@ var AuraClient = class {
   _persistSession;
   _autoRefresh;
   _detectSessionInUrl;
-  constructor(baseUrl, projectId, apiKeyOrOptions, options) {
+  /**
+   * @param baseUrl URL du projet (`https://<slug>.aurabase.cloud`).
+   * @param apiKey  Clé API du projet (`aura_anon_…`, `aura_auth_…`, `aura_sk_…`).
+   */
+  constructor(baseUrl, apiKey, options) {
     this.baseUrl = baseUrl.replace(/\/+$/, "");
-    this.projectId = projectId;
-    const resolvedOptions = typeof apiKeyOrOptions === "string" ? options : apiKeyOrOptions;
-    this.apiKey = typeof apiKeyOrOptions === "string" ? apiKeyOrOptions : apiKeyOrOptions?.apiKey ?? null;
+    const resolvedOptions = options;
+    this.apiKey = apiKey || null;
     this.fetchFn = resolvedOptions?.fetch ?? globalThis.fetch.bind(globalThis);
     const r = resolvedOptions?.retry;
     this.retryConfig = r === false ? { enabled: false, maxRetries: 0 } : r === void 0 || r === true ? { enabled: true, maxRetries: DEFAULT_MAX_RETRIES } : { enabled: r.enabled ?? true, maxRetries: r.maxRetries ?? DEFAULT_MAX_RETRIES };
@@ -73,7 +76,7 @@ var AuraClient = class {
     } else if (resolvedOptions?.auth?.persistSession === false) {
       this.authStore = new BaseAuthStore();
     } else if (typeof localStorage !== "undefined") {
-      this.authStore = new LocalAuthStore();
+      this.authStore = new LocalAuthStore(`aura-${clientScope(this.baseUrl)}-auth`);
     } else {
       this.authStore = new BaseAuthStore();
     }
@@ -104,6 +107,15 @@ var AuraClient = class {
         persistSession: this._persistSession,
         detectSessionInUrl: this._detectSessionInUrl
       });
+      this._auth.onAuthStateChange(({ event, accessToken }) => {
+        if (this._realtime) {
+          if (accessToken) {
+            this._realtime.setAuth(accessToken);
+          } else if (event === "SIGNED_OUT") {
+            this._realtime.setAuth("");
+          }
+        }
+      });
     }
     return this._auth;
   }
@@ -154,10 +166,31 @@ var AuraClient = class {
   channel(name, options) {
     return this.realtime.channel(name, options);
   }
+  /**
+   * Shortcut: remove a realtime channel by name or AuraChannel instance.
+   * Equivalent to `aura.realtime.removeChannel(channel)`.
+   */
+  removeChannel(channel) {
+    return this.realtime.removeChannel(channel);
+  }
+  /**
+   * Shortcut: remove all realtime channels and unsubscribe.
+   * Equivalent to `aura.realtime.removeAllChannels()`.
+   */
+  removeAllChannels() {
+    return this.realtime.removeAllChannels();
+  }
+  /**
+   * Shortcut: list all active realtime channels.
+   * Equivalent to `aura.realtime.getChannels()`.
+   */
+  getChannels() {
+    return this.realtime.getChannels();
+  }
 };
 var MAX_CHUNK_SIZE = 3600;
-function createServerClient(baseUrl, projectId, options) {
-  const cookieName = `aura-${projectId}-auth`;
+function createServerClient(baseUrl, apiKey, options) {
+  const cookieName = `aura-${clientScope(baseUrl)}-auth`;
   const store = new LocalAuthStore(cookieName);
   const idxRe = new RegExp(`^${cookieName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\.(\\d+)$`);
   const incoming = options.cookies.getAll();
@@ -192,7 +225,11 @@ function createServerClient(baseUrl, projectId, options) {
         let idx = 0;
         for (let i = 0; i < decoded.length; i += MAX_CHUNK_SIZE, idx++) {
           const name = `${cookieName}.${idx}`;
-          toSet.push({ name, value: decoded.slice(i, i + MAX_CHUNK_SIZE), options: defaultCookieOpts });
+          toSet.push({
+            name,
+            value: decoded.slice(i, i + MAX_CHUNK_SIZE),
+            options: defaultCookieOpts
+          });
           used.add(name);
         }
       }
@@ -203,12 +240,12 @@ function createServerClient(baseUrl, projectId, options) {
     }
     if (toSet.length > 0) options.cookies.setAll(toSet);
   });
-  return new AuraClient(baseUrl, projectId, options.apiKey, {
+  return new AuraClient(baseUrl, apiKey, {
     auth: { persistSession: false, storage: store }
   });
 }
-function createBrowserClient(baseUrl, projectId, apiKey, options) {
-  return new AuraClient(baseUrl, projectId, apiKey, options);
+function createBrowserClient(baseUrl, apiKey, options) {
+  return new AuraClient(baseUrl, apiKey, options);
 }
 
 export { createBrowserClient, createServerClient };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/aurabase-js",
-  "version": "0.4.1",
+  "version": "0.5.1",
   "description": "Official JavaScript/TypeScript client for Aurabase BaaS",
   "type": "module",
   "main": "dist/index.cjs",
@@ -44,7 +44,7 @@
     "url": "git+https://github.com/daylami555/aurabase.git",
     "directory": "aurabase-js/packages/aurabase"
   },
-  "homepage": "https://github.com/daylami555/aurabase/tree/main/aurabase-js/packages/aurabase#readme",
+  "homepage": "https://aurabase.cloud",
   "bugs": {
     "url": "https://github.com/daylami555/aurabase/issues"
   },
@@ -55,28 +55,29 @@
     "sdk",
     "client"
   ],
-  "dependencies": {
-    "@aurabase/core": "0.4.1",
-    "@aurabase/auth": "0.4.1",
-    "@aurabase/realtime": "0.4.1",
-    "@aurabase/functions": "0.4.1",
-    "@aurabase/ai": "0.4.1",
-    "@aurabase/notifications": "0.4.1",
-    "@aurabase/db": "0.4.1",
-    "@aurabase/storage": "0.4.1"
-  },
-  "devDependencies": {
-    "@types/node": "20.14.15",
-    "tsup": "^8.0.0",
-    "typescript": "^5.5.0",
-    "vitest": "^4.1.6"
-  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run && tsc --noEmit -p tsconfig.test-d.json",
     "test:types": "tsc --noEmit -p tsconfig.test-d.json",
     "test:e2e": "RUN_E2E=true vitest run --config vitest.e2e.config.ts tests/integration.test.ts",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
+    "prepack": "pnpm build",
     "typecheck:tests": "tsc --noEmit -p tsconfig.test.json"
+  },
+  "dependencies": {
+    "@aurabase/core": "workspace:*",
+    "@aurabase/auth": "workspace:*",
+    "@aurabase/db": "workspace:*",
+    "@aurabase/storage": "workspace:*",
+    "@aurabase/realtime": "workspace:*",
+    "@aurabase/functions": "workspace:*",
+    "@aurabase/ai": "workspace:*",
+    "@aurabase/notifications": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
   }
-}
+}