@aurabase/realtime 0.5.3 → 0.6.0

package/dist/index.cjs

@@ -226,6 +226,7 @@ var AuraChannel = class {
   name;
   _projectPrefix;
   _listeners = [];
+  _listenerIdCounter = 0;
   _subscribed = false;
   _sendFn = null;
   _subscribeCallback = null;
@@ -287,8 +288,69 @@ var AuraChannel = class {
   get fullName() {
     return `${this._projectPrefix()}${this.name}`;
   }
+  /**
+   * Signature d'implémentation de `.on()`.
+   * Retourne une fonction de désabonnement direct `() => void` qui proxy également l'instance du canal pour le chaînage fluide.
+   */
   on(type, filter, callback) {
-    this._listeners.push({ type, filter, callback });
+    const id = ++this._listenerIdCounter;
+    this._listeners.push({
+      id,
+      type,
+      filter,
+      callback
+    });
+    const unsubscribe = () => {
+      const idx = this._listeners.findIndex((l) => l.id === id);
+      if (idx !== -1) {
+        this._listeners.splice(idx, 1);
+      }
+    };
+    return new Proxy(unsubscribe, {
+      get: (_target, prop) => {
+        const val = this[prop];
+        if (typeof val === "function") {
+          return (...args) => Reflect.apply(val, this, args);
+        }
+        return val;
+      }
+    });
+  }
+  /**
+   * Supprime un ou plusieurs listeners du canal sans clore le canal ni couper le WebSocket.
+   *
+   * - `off(type, filter, callback)` : supprime le listener exact.
+   * - `off(type, filter)` : supprime les listeners correspondant à ce type et ce filtre.
+   * - `off(type)` : supprime tous les listeners du type spécifié.
+   * - `off()` : supprime tous les listeners locaux du canal.
+   */
+  off(type, filter, callback) {
+    if (!type) {
+      this._listeners.length = 0;
+      return this;
+    }
+    const filtered = this._listeners.filter((l) => {
+      if (l.type !== type) return true;
+      if (filter) {
+        const filterMeta = filter;
+        const listenerFilter = l.filter;
+        if ("event" in filter && "event" in l.filter && listenerFilter.event !== filterMeta.event) {
+          return true;
+        }
+        if ("schema" in filter && listenerFilter.schema !== filterMeta.schema) {
+          return true;
+        }
+        if ("table" in filter && listenerFilter.table !== filterMeta.table) {
+          return true;
+        }
+      }
+      if (callback && l.callback !== callback) {
+        return true;
+      }
+      return false;
+    });
+    this._listeners.length = 0;
+    this._listeners.push(...filtered);
     return this;
   }
   // ─── Subscribe ──────────────────────────────────────────────────────────
@@ -698,32 +760,57 @@ var AuraChannel = class {
               }
             }
             const cdcPayload = payload && typeof payload === "object" ? payload : {};
-            if (cdcPayload.new === void 0 && cdcPayload.record !== void 0) {
-              cdcPayload.new = cdcPayload.record;
-            }
-            if (cdcPayload.old === void 0 && cdcPayload.old_record !== void 0) {
-              cdcPayload.old = cdcPayload.old_record;
-            }
-            if (cdcPayload.eventType === void 0 && cdcPayload.type !== void 0) {
-              cdcPayload.eventType = cdcPayload.type;
-            }
-            const enrichedEvent = Object.assign(Object.create(event), {
-              new: cdcPayload.record,
-              old: cdcPayload.old_record,
-              eventType: cdcPayload.type,
-              schema: cdcPayload.schema,
-              table: cdcPayload.table
-            });
+            const rawRecord = cdcPayload.record ?? cdcPayload.new ?? null;
+            const rawOldRecord = cdcPayload.old_record ?? cdcPayload.old ?? null;
+            const rawType = cdcPayload.type ?? cdcPayload.eventType;
+            const eventTypeString = typeof rawType === "string" ? rawType : typeof eventType === "string" ? eventType : "INSERT";
+            const cdcType = eventTypeString.toUpperCase();
+            const recordNew = cdcType === "DELETE" ? null : rawRecord;
+            const recordOld = cdcType === "INSERT" ? null : rawOldRecord;
+            const enrichedPayload = {
+              ...cdcPayload,
+              record: rawRecord,
+              old_record: rawOldRecord,
+              new: recordNew,
+              old: recordOld,
+              eventType: cdcType,
+              schema: cdcPayload.schema ?? filter.schema ?? "public",
+              table: cdcPayload.table ?? filter.table ?? "",
+              commit_timestamp: cdcPayload.commit_timestamp ?? event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+            };
+            const enrichedEvent = {
+              ...event,
+              schema: cdcPayload.schema ?? filter.schema ?? "public",
+              table: cdcPayload.table ?? filter.table ?? "",
+              commit_timestamp: cdcPayload.commit_timestamp ?? event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+              errors: cdcPayload.errors,
+              id: event.id,
+              topic: event.topic,
+              timestamp: event.timestamp,
+              eventType: cdcType,
+              event: cdcType === "INSERT" ? "insert" : cdcType === "UPDATE" ? "update" : "delete",
+              new: recordNew,
+              old: recordOld,
+              payload: enrichedPayload
+            };
             listener.callback(enrichedEvent);
           }
         }
       } else if (listener.type === "broadcast") {
         if (eventType === "broadcast") {
           const filter = listener.filter;
-          const broadcastPayload = event.payload && typeof event.payload === "object" ? event.payload : void 0;
-          const broadcastEvent = broadcastPayload?.event;
+          const broadcastPayload = event.payload && typeof event.payload === "object" ? event.payload : {};
+          const broadcastEvent = broadcastPayload.event ?? "broadcast";
           if (!filter.event || filter.event === "*" || broadcastEvent === filter.event) {
-            listener.callback(event);
+            const enrichedBroadcast = {
+              id: event.id,
+              topic: event.topic,
+              timestamp: event.timestamp,
+              allowed_sub_ids: event.allowed_sub_ids,
+              event: broadcastEvent,
+              payload: broadcastPayload
+            };
+            listener.callback(enrichedBroadcast);
           }
         }
       } else if (listener.type === "presence") {
@@ -1372,8 +1459,25 @@ var RealtimeService = class _RealtimeService {
    * await aura.realtime.httpBroadcast(`${PROJECT_ID}:room-1`, 'cursor', { x: 10, y: 20 })
    * ```
    */
-  httpBroadcast(channel, event, payload = {}) {
-    const prefix = this._projectPrefix();
+  /**
+   * Envoie un broadcast par HTTP (REST), sans connexion WebSocket ouverte
+   * (parité `@supabase/realtime-js`). Utile côté serveur/edge.
+   *
+   * POST `/v1/realtime/broadcast` avec le contrat du handler backend
+   * (`broadcast.rs`) : `{ channel, payload }`, `channel` préfixé par le projet,
+   * `event` replié dans `payload` (aligné sur le broadcast WS).
+   *
+   * Le canal peut être fourni :
+   * - sous forme courte (`'room-1'`) si une session utilisateur est présente,
+   * - sous forme courte avec l'option `{ projectId: '<uuid>' }`,
+   * - ou déjà qualifié (`'<project_id>:room-1'`).
+   */
+  httpBroadcast(channel, event, payload = {}, options) {
+    const explicitProjectId = options?.projectId ?? this.client.projectId;
+    let prefix = this._projectPrefix();
+    if (!prefix && explicitProjectId) {
+      prefix = explicitProjectId.endsWith(":") ? explicitProjectId : `${explicitProjectId}:`;
+    }
     let fullChannel;
     if (prefix) {
       fullChannel = channel.startsWith(prefix) ? channel : `${prefix}${channel}`;
@@ -1385,7 +1489,7 @@ var RealtimeService = class _RealtimeService {
         error: new core.AuraError(0, {
           error: {
             code: "realtime_channel_non_qualifie",
-            message: `httpBroadcast: le canal "${channel}" n'est pas qualifi\xE9 et aucune session n'est ouverte \u2014 le SDK n'a donc aucun \`project_id\` \xE0 lui pr\xE9fixer, alors que le serveur l'EXIGE (403 \xAB Le canal n'appartient pas \xE0 ce projet \xBB). Passez le canal sous la forme "<project_id>:` + channel + `" \u2014 c'est la forme attendue c\xF4t\xE9 serveur/edge, o\xF9 il n'y a pas de session utilisateur.`
+            message: `httpBroadcast: le canal "${channel}" n'est pas qualifi\xE9 et aucune session n'est ouverte \u2014 le SDK n'a donc aucun \`project_id\` \xE0 lui pr\xE9fixer, alors que le serveur l'EXIGE (403 \xAB Le canal n'appartient pas \xE0 ce projet \xBB). Passez le canal sous la forme "<project_id>:` + channel + `" ou sp\xE9cifiez l'option { projectId: "<uuid>" } \u2014 c'est la forme attendue c\xF4t\xE9 serveur/edge, o\xF9 il n'y a pas de session utilisateur.`
           }
         })
       });

package/dist/index.d.cts

@@ -1,14 +1,21 @@
-import { ChannelConfig, PostgresChangesFilter, RealtimeEvent, BroadcastFilter, PresenceFilter, PresenceState, SubscribeCallback, BroadcastPayload, BroadcastSendStatus, ServerMessage, AuraClientLike, AuraResponse } from '@aurabase/core';
+import { ChannelConfig, PostgresChangesFilter, RealtimePostgresInsertPayload, RealtimePostgresUpdatePayload, RealtimePostgresDeletePayload, RealtimePostgresChangesPayload, BroadcastFilter, RealtimeBroadcastEvent, PresenceFilter, PresenceState, RealtimeEvent, RealtimeListenType, SubscribeCallback, BroadcastPayload, BroadcastSendStatus, ServerMessage, AuraClientLike, AuraResponse } from '@aurabase/core';
 
+/**
+ * Fonction de désabonnement retournée par `.on()`, enrichie avec les méthodes du canal pour permettre le chaînage fluide.
+ */
+type AuraChannelSubscription = (() => void) & AuraChannel;
 type ListenerEntry = {
+    id: number;
     type: 'postgres_changes';
     filter: PostgresChangesFilter;
-    callback: (payload: RealtimeEvent) => void;
+    callback: (payload: RealtimePostgresChangesPayload<Record<string, unknown>>) => void;
 } | {
+    id: number;
     type: 'broadcast';
     filter: BroadcastFilter;
-    callback: (payload: RealtimeEvent) => void;
+    callback: (payload: RealtimeBroadcastEvent<Record<string, unknown>>) => void;
 } | {
+    id: number;
     type: 'presence';
     filter: PresenceFilter;
     callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void;
@@ -52,6 +59,7 @@ declare class AuraChannel {
     readonly name: string;
     private readonly _projectPrefix;
     private readonly _listeners;
+    private _listenerIdCounter;
     private _subscribed;
     private _sendFn;
     private _subscribeCallback;
@@ -101,12 +109,49 @@ declare class AuraChannel {
     /** Full channel name with project prefix (for server protocol) */
     get fullName(): string;
     /**
-     * Register a listener for a specific event type.
-     * Returns `this` for chaining.
+     * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage INSERT.
+     * Typé spécifiquement avec `new: TRow` et `old: null`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
+        event: 'INSERT';
+    }, callback: (payload: RealtimePostgresInsertPayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage UPDATE.
+     * Typé spécifiquement avec `new: TRow` et `old: Partial<TRow>`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
+        event: 'UPDATE';
+    }, callback: (payload: RealtimePostgresUpdatePayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage DELETE.
+     * Typé spécifiquement avec `new: null` et `old: Partial<TRow> | null`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
+        event: 'DELETE';
+    }, callback: (payload: RealtimePostgresDeletePayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour les événements PostgreSQL (CDC) (INSERT, UPDATE, DELETE ou '*').
+     * Typé comme union discriminée par `eventType`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter, callback: (payload: RealtimePostgresChangesPayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener broadcast avec typage générique du payload applicatif.
+     * Permet l'accès direct et typé à `({ payload }) => payload.x` ainsi qu'aux métadonnées.
      */
-    on(type: 'postgres_changes', filter: PostgresChangesFilter, callback: (payload: RealtimeEvent) => void): this;
-    on(type: 'broadcast', filter: BroadcastFilter, callback: (payload: RealtimeEvent) => void): this;
-    on(type: 'presence', filter: PresenceFilter, callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void): this;
+    on<TPayload = Record<string, unknown>>(type: 'broadcast', filter: BroadcastFilter, callback: (payload: RealtimeBroadcastEvent<TPayload>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour la présence.
+     */
+    on(type: 'presence', filter: PresenceFilter, callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void): AuraChannelSubscription;
+    /**
+     * Supprime un ou plusieurs listeners du canal sans clore le canal ni couper le WebSocket.
+     *
+     * - `off(type, filter, callback)` : supprime le listener exact.
+     * - `off(type, filter)` : supprime les listeners correspondant à ce type et ce filtre.
+     * - `off(type)` : supprime tous les listeners du type spécifié.
+     * - `off()` : supprime tous les listeners locaux du canal.
+     */
+    off(type?: RealtimeListenType, filter?: PostgresChangesFilter | BroadcastFilter | PresenceFilter, callback?: (payload: unknown) => void): this;
     /**
      * Subscribe to the channel. Sends the Subscribe message to the server
      * with the full config (postgres_changes, broadcast, presence).
@@ -371,6 +416,13 @@ declare const HEARTBEAT_INTERVAL_MS = 25000;
  *   })
  * ```
  */
+interface HttpBroadcastOptions {
+    /**
+     * Identifiant UUID du projet pour qualifier le canal lorsque le SDK fonctionne sans session
+     * utilisateur (ex: côté serveur ou edge avec une clé API service_role).
+     */
+    projectId?: string;
+}
 declare class RealtimeService {
     private readonly client;
     private _ws;
@@ -596,7 +648,20 @@ declare class RealtimeService {
      * await aura.realtime.httpBroadcast(`${PROJECT_ID}:room-1`, 'cursor', { x: 10, y: 20 })
      * ```
      */
-    httpBroadcast(channel: string, event: string, payload?: Record<string, unknown>): Promise<AuraResponse<null>>;
+    /**
+     * Envoie un broadcast par HTTP (REST), sans connexion WebSocket ouverte
+     * (parité `@supabase/realtime-js`). Utile côté serveur/edge.
+     *
+     * POST `/v1/realtime/broadcast` avec le contrat du handler backend
+     * (`broadcast.rs`) : `{ channel, payload }`, `channel` préfixé par le projet,
+     * `event` replié dans `payload` (aligné sur le broadcast WS).
+     *
+     * Le canal peut être fourni :
+     * - sous forme courte (`'room-1'`) si une session utilisateur est présente,
+     * - sous forme courte avec l'option `{ projectId: '<uuid>' }`,
+     * - ou déjà qualifié (`'<project_id>:room-1'`).
+     */
+    httpBroadcast(channel: string, event: string, payload?: Record<string, unknown>, options?: HttpBroadcastOptions): Promise<AuraResponse<null>>;
     /**
      * Schedule proactive token refresh at 80% of the JWT TTL.
      * Prevents token expiration during an active WebSocket session.
@@ -628,4 +693,4 @@ declare class RealtimeService {
     private _dispatch;
 }
 
-export { AuraChannel, type ConnectionState, DEFAULT_SUBSCRIBE_TIMEOUT_MS, HEARTBEAT_INTERVAL_MS, HeartbeatManager, RealtimeConnectionError, type RealtimeErrorPhase, RealtimeService };
+export { AuraChannel, type AuraChannelSubscription, type ConnectionState, DEFAULT_SUBSCRIBE_TIMEOUT_MS, HEARTBEAT_INTERVAL_MS, HeartbeatManager, type HttpBroadcastOptions, RealtimeConnectionError, type RealtimeErrorPhase, RealtimeService };

package/dist/index.d.ts

@@ -1,14 +1,21 @@
-import { ChannelConfig, PostgresChangesFilter, RealtimeEvent, BroadcastFilter, PresenceFilter, PresenceState, SubscribeCallback, BroadcastPayload, BroadcastSendStatus, ServerMessage, AuraClientLike, AuraResponse } from '@aurabase/core';
+import { ChannelConfig, PostgresChangesFilter, RealtimePostgresInsertPayload, RealtimePostgresUpdatePayload, RealtimePostgresDeletePayload, RealtimePostgresChangesPayload, BroadcastFilter, RealtimeBroadcastEvent, PresenceFilter, PresenceState, RealtimeEvent, RealtimeListenType, SubscribeCallback, BroadcastPayload, BroadcastSendStatus, ServerMessage, AuraClientLike, AuraResponse } from '@aurabase/core';
 
+/**
+ * Fonction de désabonnement retournée par `.on()`, enrichie avec les méthodes du canal pour permettre le chaînage fluide.
+ */
+type AuraChannelSubscription = (() => void) & AuraChannel;
 type ListenerEntry = {
+    id: number;
     type: 'postgres_changes';
     filter: PostgresChangesFilter;
-    callback: (payload: RealtimeEvent) => void;
+    callback: (payload: RealtimePostgresChangesPayload<Record<string, unknown>>) => void;
 } | {
+    id: number;
     type: 'broadcast';
     filter: BroadcastFilter;
-    callback: (payload: RealtimeEvent) => void;
+    callback: (payload: RealtimeBroadcastEvent<Record<string, unknown>>) => void;
 } | {
+    id: number;
     type: 'presence';
     filter: PresenceFilter;
     callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void;
@@ -52,6 +59,7 @@ declare class AuraChannel {
     readonly name: string;
     private readonly _projectPrefix;
     private readonly _listeners;
+    private _listenerIdCounter;
     private _subscribed;
     private _sendFn;
     private _subscribeCallback;
@@ -101,12 +109,49 @@ declare class AuraChannel {
     /** Full channel name with project prefix (for server protocol) */
     get fullName(): string;
     /**
-     * Register a listener for a specific event type.
-     * Returns `this` for chaining.
+     * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage INSERT.
+     * Typé spécifiquement avec `new: TRow` et `old: null`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
+        event: 'INSERT';
+    }, callback: (payload: RealtimePostgresInsertPayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage UPDATE.
+     * Typé spécifiquement avec `new: TRow` et `old: Partial<TRow>`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
+        event: 'UPDATE';
+    }, callback: (payload: RealtimePostgresUpdatePayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage DELETE.
+     * Typé spécifiquement avec `new: null` et `old: Partial<TRow> | null`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
+        event: 'DELETE';
+    }, callback: (payload: RealtimePostgresDeletePayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour les événements PostgreSQL (CDC) (INSERT, UPDATE, DELETE ou '*').
+     * Typé comme union discriminée par `eventType`.
+     */
+    on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter, callback: (payload: RealtimePostgresChangesPayload<TRow>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener broadcast avec typage générique du payload applicatif.
+     * Permet l'accès direct et typé à `({ payload }) => payload.x` ainsi qu'aux métadonnées.
      */
-    on(type: 'postgres_changes', filter: PostgresChangesFilter, callback: (payload: RealtimeEvent) => void): this;
-    on(type: 'broadcast', filter: BroadcastFilter, callback: (payload: RealtimeEvent) => void): this;
-    on(type: 'presence', filter: PresenceFilter, callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void): this;
+    on<TPayload = Record<string, unknown>>(type: 'broadcast', filter: BroadcastFilter, callback: (payload: RealtimeBroadcastEvent<TPayload>) => void): AuraChannelSubscription;
+    /**
+     * Enregistre un listener pour la présence.
+     */
+    on(type: 'presence', filter: PresenceFilter, callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void): AuraChannelSubscription;
+    /**
+     * Supprime un ou plusieurs listeners du canal sans clore le canal ni couper le WebSocket.
+     *
+     * - `off(type, filter, callback)` : supprime le listener exact.
+     * - `off(type, filter)` : supprime les listeners correspondant à ce type et ce filtre.
+     * - `off(type)` : supprime tous les listeners du type spécifié.
+     * - `off()` : supprime tous les listeners locaux du canal.
+     */
+    off(type?: RealtimeListenType, filter?: PostgresChangesFilter | BroadcastFilter | PresenceFilter, callback?: (payload: unknown) => void): this;
     /**
      * Subscribe to the channel. Sends the Subscribe message to the server
      * with the full config (postgres_changes, broadcast, presence).
@@ -371,6 +416,13 @@ declare const HEARTBEAT_INTERVAL_MS = 25000;
  *   })
  * ```
  */
+interface HttpBroadcastOptions {
+    /**
+     * Identifiant UUID du projet pour qualifier le canal lorsque le SDK fonctionne sans session
+     * utilisateur (ex: côté serveur ou edge avec une clé API service_role).
+     */
+    projectId?: string;
+}
 declare class RealtimeService {
     private readonly client;
     private _ws;
@@ -596,7 +648,20 @@ declare class RealtimeService {
      * await aura.realtime.httpBroadcast(`${PROJECT_ID}:room-1`, 'cursor', { x: 10, y: 20 })
      * ```
      */
-    httpBroadcast(channel: string, event: string, payload?: Record<string, unknown>): Promise<AuraResponse<null>>;
+    /**
+     * Envoie un broadcast par HTTP (REST), sans connexion WebSocket ouverte
+     * (parité `@supabase/realtime-js`). Utile côté serveur/edge.
+     *
+     * POST `/v1/realtime/broadcast` avec le contrat du handler backend
+     * (`broadcast.rs`) : `{ channel, payload }`, `channel` préfixé par le projet,
+     * `event` replié dans `payload` (aligné sur le broadcast WS).
+     *
+     * Le canal peut être fourni :
+     * - sous forme courte (`'room-1'`) si une session utilisateur est présente,
+     * - sous forme courte avec l'option `{ projectId: '<uuid>' }`,
+     * - ou déjà qualifié (`'<project_id>:room-1'`).
+     */
+    httpBroadcast(channel: string, event: string, payload?: Record<string, unknown>, options?: HttpBroadcastOptions): Promise<AuraResponse<null>>;
     /**
      * Schedule proactive token refresh at 80% of the JWT TTL.
      * Prevents token expiration during an active WebSocket session.
@@ -628,4 +693,4 @@ declare class RealtimeService {
     private _dispatch;
 }
 
-export { AuraChannel, type ConnectionState, DEFAULT_SUBSCRIBE_TIMEOUT_MS, HEARTBEAT_INTERVAL_MS, HeartbeatManager, RealtimeConnectionError, type RealtimeErrorPhase, RealtimeService };
+export { AuraChannel, type AuraChannelSubscription, type ConnectionState, DEFAULT_SUBSCRIBE_TIMEOUT_MS, HEARTBEAT_INTERVAL_MS, HeartbeatManager, type HttpBroadcastOptions, RealtimeConnectionError, type RealtimeErrorPhase, RealtimeService };

package/dist/index.js

@@ -224,6 +224,7 @@ var AuraChannel = class {
   name;
   _projectPrefix;
   _listeners = [];
+  _listenerIdCounter = 0;
   _subscribed = false;
   _sendFn = null;
   _subscribeCallback = null;
@@ -285,8 +286,69 @@ var AuraChannel = class {
   get fullName() {
     return `${this._projectPrefix()}${this.name}`;
   }
+  /**
+   * Signature d'implémentation de `.on()`.
+   * Retourne une fonction de désabonnement direct `() => void` qui proxy également l'instance du canal pour le chaînage fluide.
+   */
   on(type, filter, callback) {
-    this._listeners.push({ type, filter, callback });
+    const id = ++this._listenerIdCounter;
+    this._listeners.push({
+      id,
+      type,
+      filter,
+      callback
+    });
+    const unsubscribe = () => {
+      const idx = this._listeners.findIndex((l) => l.id === id);
+      if (idx !== -1) {
+        this._listeners.splice(idx, 1);
+      }
+    };
+    return new Proxy(unsubscribe, {
+      get: (_target, prop) => {
+        const val = this[prop];
+        if (typeof val === "function") {
+          return (...args) => Reflect.apply(val, this, args);
+        }
+        return val;
+      }
+    });
+  }
+  /**
+   * Supprime un ou plusieurs listeners du canal sans clore le canal ni couper le WebSocket.
+   *
+   * - `off(type, filter, callback)` : supprime le listener exact.
+   * - `off(type, filter)` : supprime les listeners correspondant à ce type et ce filtre.
+   * - `off(type)` : supprime tous les listeners du type spécifié.
+   * - `off()` : supprime tous les listeners locaux du canal.
+   */
+  off(type, filter, callback) {
+    if (!type) {
+      this._listeners.length = 0;
+      return this;
+    }
+    const filtered = this._listeners.filter((l) => {
+      if (l.type !== type) return true;
+      if (filter) {
+        const filterMeta = filter;
+        const listenerFilter = l.filter;
+        if ("event" in filter && "event" in l.filter && listenerFilter.event !== filterMeta.event) {
+          return true;
+        }
+        if ("schema" in filter && listenerFilter.schema !== filterMeta.schema) {
+          return true;
+        }
+        if ("table" in filter && listenerFilter.table !== filterMeta.table) {
+          return true;
+        }
+      }
+      if (callback && l.callback !== callback) {
+        return true;
+      }
+      return false;
+    });
+    this._listeners.length = 0;
+    this._listeners.push(...filtered);
     return this;
   }
   // ─── Subscribe ──────────────────────────────────────────────────────────
@@ -696,32 +758,57 @@ var AuraChannel = class {
               }
             }
             const cdcPayload = payload && typeof payload === "object" ? payload : {};
-            if (cdcPayload.new === void 0 && cdcPayload.record !== void 0) {
-              cdcPayload.new = cdcPayload.record;
-            }
-            if (cdcPayload.old === void 0 && cdcPayload.old_record !== void 0) {
-              cdcPayload.old = cdcPayload.old_record;
-            }
-            if (cdcPayload.eventType === void 0 && cdcPayload.type !== void 0) {
-              cdcPayload.eventType = cdcPayload.type;
-            }
-            const enrichedEvent = Object.assign(Object.create(event), {
-              new: cdcPayload.record,
-              old: cdcPayload.old_record,
-              eventType: cdcPayload.type,
-              schema: cdcPayload.schema,
-              table: cdcPayload.table
-            });
+            const rawRecord = cdcPayload.record ?? cdcPayload.new ?? null;
+            const rawOldRecord = cdcPayload.old_record ?? cdcPayload.old ?? null;
+            const rawType = cdcPayload.type ?? cdcPayload.eventType;
+            const eventTypeString = typeof rawType === "string" ? rawType : typeof eventType === "string" ? eventType : "INSERT";
+            const cdcType = eventTypeString.toUpperCase();
+            const recordNew = cdcType === "DELETE" ? null : rawRecord;
+            const recordOld = cdcType === "INSERT" ? null : rawOldRecord;
+            const enrichedPayload = {
+              ...cdcPayload,
+              record: rawRecord,
+              old_record: rawOldRecord,
+              new: recordNew,
+              old: recordOld,
+              eventType: cdcType,
+              schema: cdcPayload.schema ?? filter.schema ?? "public",
+              table: cdcPayload.table ?? filter.table ?? "",
+              commit_timestamp: cdcPayload.commit_timestamp ?? event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+            };
+            const enrichedEvent = {
+              ...event,
+              schema: cdcPayload.schema ?? filter.schema ?? "public",
+              table: cdcPayload.table ?? filter.table ?? "",
+              commit_timestamp: cdcPayload.commit_timestamp ?? event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+              errors: cdcPayload.errors,
+              id: event.id,
+              topic: event.topic,
+              timestamp: event.timestamp,
+              eventType: cdcType,
+              event: cdcType === "INSERT" ? "insert" : cdcType === "UPDATE" ? "update" : "delete",
+              new: recordNew,
+              old: recordOld,
+              payload: enrichedPayload
+            };
             listener.callback(enrichedEvent);
           }
         }
       } else if (listener.type === "broadcast") {
         if (eventType === "broadcast") {
           const filter = listener.filter;
-          const broadcastPayload = event.payload && typeof event.payload === "object" ? event.payload : void 0;
-          const broadcastEvent = broadcastPayload?.event;
+          const broadcastPayload = event.payload && typeof event.payload === "object" ? event.payload : {};
+          const broadcastEvent = broadcastPayload.event ?? "broadcast";
           if (!filter.event || filter.event === "*" || broadcastEvent === filter.event) {
-            listener.callback(event);
+            const enrichedBroadcast = {
+              id: event.id,
+              topic: event.topic,
+              timestamp: event.timestamp,
+              allowed_sub_ids: event.allowed_sub_ids,
+              event: broadcastEvent,
+              payload: broadcastPayload
+            };
+            listener.callback(enrichedBroadcast);
           }
         }
       } else if (listener.type === "presence") {
@@ -1370,8 +1457,25 @@ var RealtimeService = class _RealtimeService {
    * await aura.realtime.httpBroadcast(`${PROJECT_ID}:room-1`, 'cursor', { x: 10, y: 20 })
    * ```
    */
-  httpBroadcast(channel, event, payload = {}) {
-    const prefix = this._projectPrefix();
+  /**
+   * Envoie un broadcast par HTTP (REST), sans connexion WebSocket ouverte
+   * (parité `@supabase/realtime-js`). Utile côté serveur/edge.
+   *
+   * POST `/v1/realtime/broadcast` avec le contrat du handler backend
+   * (`broadcast.rs`) : `{ channel, payload }`, `channel` préfixé par le projet,
+   * `event` replié dans `payload` (aligné sur le broadcast WS).
+   *
+   * Le canal peut être fourni :
+   * - sous forme courte (`'room-1'`) si une session utilisateur est présente,
+   * - sous forme courte avec l'option `{ projectId: '<uuid>' }`,
+   * - ou déjà qualifié (`'<project_id>:room-1'`).
+   */
+  httpBroadcast(channel, event, payload = {}, options) {
+    const explicitProjectId = options?.projectId ?? this.client.projectId;
+    let prefix = this._projectPrefix();
+    if (!prefix && explicitProjectId) {
+      prefix = explicitProjectId.endsWith(":") ? explicitProjectId : `${explicitProjectId}:`;
+    }
     let fullChannel;
     if (prefix) {
       fullChannel = channel.startsWith(prefix) ? channel : `${prefix}${channel}`;
@@ -1383,7 +1487,7 @@ var RealtimeService = class _RealtimeService {
         error: new AuraError(0, {
           error: {
             code: "realtime_channel_non_qualifie",
-            message: `httpBroadcast: le canal "${channel}" n'est pas qualifi\xE9 et aucune session n'est ouverte \u2014 le SDK n'a donc aucun \`project_id\` \xE0 lui pr\xE9fixer, alors que le serveur l'EXIGE (403 \xAB Le canal n'appartient pas \xE0 ce projet \xBB). Passez le canal sous la forme "<project_id>:` + channel + `" \u2014 c'est la forme attendue c\xF4t\xE9 serveur/edge, o\xF9 il n'y a pas de session utilisateur.`
+            message: `httpBroadcast: le canal "${channel}" n'est pas qualifi\xE9 et aucune session n'est ouverte \u2014 le SDK n'a donc aucun \`project_id\` \xE0 lui pr\xE9fixer, alors que le serveur l'EXIGE (403 \xAB Le canal n'appartient pas \xE0 ce projet \xBB). Passez le canal sous la forme "<project_id>:` + channel + `" ou sp\xE9cifiez l'option { projectId: "<uuid>" } \u2014 c'est la forme attendue c\xF4t\xE9 serveur/edge, o\xF9 il n'y a pas de session utilisateur.`
           }
         })
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/realtime",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Service temps réel du SDK Aurabase (postgres_changes, broadcast, presence)",
   "type": "module",
   "main": "dist/index.cjs",
@@ -45,7 +45,7 @@
     "realtime"
   ],
   "dependencies": {
-    "@aurabase/core": "0.5.3"
+    "@aurabase/core": "0.6.0"
   },
   "devDependencies": {
     "@types/node": "20.14.15",