@aurabase/realtime 0.5.4 → 0.6.1

package/README.md

@@ -174,6 +174,7 @@ const status = await room.send({ type: 'broadcast', event: 'cursor-pos', payload
 | `'timeout'` | `ack` demandé sur un canal abonné, aucun accusé reçu en 5 s : l'accusé s'est **perdu** (lien coupé, serveur saturé). | oui |
 | `'not_connected'` | Aucun transport lié, ou socket non-OPEN — le message a été **jeté**. | **non** |
 | `'requires_subscription'` | Le serveur n'a **pas d'abonnement** pour ce canal : jamais souscrit, souscription **refusée** (RLS, `private_only`, quota) ou **révoquée** depuis (voir ci-dessous). | **non** |
+| `'invalid_payload'` | Le `payload` porte lui-même une clé `event` : elle écraserait le nom de l'événement (replié dans le payload du fil). Renommez-la (`kind`…). | **non** |
 | `'error'` | L'envoi a levé (sérialisation, transport en erreur). | non |
 
 Avant la remédiation C18/N24, ces trois derniers cas rendaient tous `'error'` (et le

package/dist/index.cjs

@@ -223,6 +223,7 @@ function matchesColumnFilter(filter, record) {
 var DEFAULT_SUBSCRIBE_TIMEOUT_MS = 1e4;
 var PERTE_D_ABONNEMENT = /Non abonné au canal|Accès révoqué au channel/;
 var AuraChannel = class {
+  /** Nom du canal tel que passé à `realtime.channel(name)`. */
   name;
   _projectPrefix;
   _listeners = [];
@@ -288,6 +289,21 @@ var AuraChannel = class {
   get fullName() {
     return `${this._projectPrefix()}${this.name}`;
   }
+  /**
+   * Le nom de canal porté par un message serveur désigne-t-il CE canal ?
+   *
+   * Le serveur nomme toujours le canal qualifié `<project_id>:<nom>`. Quand le SDK connaît le
+   * projet (session), `fullName` est déjà qualifié : égalité stricte. Sans session (clé API seule),
+   * le SDK émet le canal nu et la passerelle le qualifie : on retire alors exactement UN segment
+   * de projet (sans `:`) devant le nom. Un nom qui ne fait que se terminer par `:<nom>`
+   * (`<pid>:x:<nom>`) désigne un AUTRE canal.
+   */
+  _isOwnServerChannel(serverChannel) {
+    if (serverChannel === this.fullName || serverChannel === this.name) return true;
+    if (this.fullName !== this.name) return false;
+    const sep = serverChannel.indexOf(":");
+    return sep > 0 && serverChannel.slice(sep + 1) === 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.
@@ -359,9 +375,11 @@ var AuraChannel = class {
    * with the full config (postgres_changes, broadcast, presence).
    *
    * Le callback reçoit les mêmes statuts que `@supabase/realtime-js` :
-   * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ;
-   * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake ou
-   *                     coupure inattendue de la connexion ;
+   * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ; émis de nouveau quand une
+   *                     écoute `postgres_changes` perdue (voir `CHANNEL_ERROR`) est rétablie ;
+   * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake, coupure
+   *                     inattendue de la connexion, ou écoute `postgres_changes` du projet
+   *                     perdue (l'abonnement est conservé, `SUBSCRIBED` suit sa reprise) ;
    * - `TIMED_OUT`     — aucune réponse du serveur dans `timeoutMs` après l'envoi ;
    * - `CLOSED`        — le canal a été fermé volontairement (`unsubscribe()`,
    *                     `removeChannel()`, `removeAllChannels()`, `disconnect()`).
@@ -510,6 +528,10 @@ var AuraChannel = class {
    */
   send(message) {
     return new Promise((resolve) => {
+      if (message.payload && Object.prototype.hasOwnProperty.call(message.payload, "event")) {
+        resolve("invalid_payload");
+        return;
+      }
       if (!this._sendFn) {
         resolve("not_connected");
         return;
@@ -642,7 +664,7 @@ var AuraChannel = class {
       case "error": {
         const errMsg = msg;
         const errChannel = errMsg.channel;
-        if (errChannel && errChannel !== this.fullName && errChannel !== this.name) {
+        if (errChannel && !this._isOwnServerChannel(errChannel)) {
           break;
         }
         this._clearSubscribeTimeout();
@@ -655,6 +677,12 @@ var AuraChannel = class {
         }
         break;
       }
+      case "channel_recovered": {
+        if (!this._isOwnServerChannel(msg.channel)) break;
+        if (this._serverState !== "subscribed") break;
+        this._emitStatus("SUBSCRIBED");
+        break;
+      }
       case "token_refreshed":
         break;
       case "broadcast_ack": {
@@ -1473,6 +1501,17 @@ var RealtimeService = class _RealtimeService {
    * - ou déjà qualifié (`'<project_id>:room-1'`).
    */
   httpBroadcast(channel, event, payload = {}, options) {
+    if (Object.prototype.hasOwnProperty.call(payload, "event")) {
+      return Promise.resolve({
+        data: null,
+        error: new core.AuraError(0, {
+          error: {
+            code: "realtime_payload_event_reserved",
+            message: "httpBroadcast: le payload contient une cl\xE9 `event`, r\xE9serv\xE9e au nom de l'\xE9v\xE9nement (elle \xE9craserait celui-ci chez les abonn\xE9s). Renommez-la (`eventName`, `kind`\u2026)."
+          }
+        })
+      });
+    }
     const explicitProjectId = options?.projectId ?? this.client.projectId;
     let prefix = this._projectPrefix();
     if (!prefix && explicitProjectId) {

package/dist/index.d.cts

@@ -56,6 +56,7 @@ declare const DEFAULT_SUBSCRIBE_TIMEOUT_MS = 10000;
  * ```
  */
 declare class AuraChannel {
+    /** Nom du canal tel que passé à `realtime.channel(name)`. */
     readonly name: string;
     private readonly _projectPrefix;
     private readonly _listeners;
@@ -108,6 +109,16 @@ declare class AuraChannel {
     private _nextRef;
     /** Full channel name with project prefix (for server protocol) */
     get fullName(): string;
+    /**
+     * Le nom de canal porté par un message serveur désigne-t-il CE canal ?
+     *
+     * Le serveur nomme toujours le canal qualifié `<project_id>:<nom>`. Quand le SDK connaît le
+     * projet (session), `fullName` est déjà qualifié : égalité stricte. Sans session (clé API seule),
+     * le SDK émet le canal nu et la passerelle le qualifie : on retire alors exactement UN segment
+     * de projet (sans `:`) devant le nom. Un nom qui ne fait que se terminer par `:<nom>`
+     * (`<pid>:x:<nom>`) désigne un AUTRE canal.
+     */
+    _isOwnServerChannel(serverChannel: string): boolean;
     /**
      * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage INSERT.
      * Typé spécifiquement avec `new: TRow` et `old: null`.
@@ -117,14 +128,16 @@ declare class AuraChannel {
     }, 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>`.
+     * Typé spécifiquement avec `new: TRow` et `old: Partial<TRow>` : `old` ne porte que
+     * la clé primaire de l'ancienne ligne, jamais ses autres valeurs.
      */
     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`.
+     * Typé spécifiquement avec `new: null` et `old: Partial<TRow> | null` : `old` ne porte
+     * que la clé primaire de la ligne supprimée.
      */
     on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
         event: 'DELETE';
@@ -157,9 +170,11 @@ declare class AuraChannel {
      * with the full config (postgres_changes, broadcast, presence).
      *
      * Le callback reçoit les mêmes statuts que `@supabase/realtime-js` :
-     * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ;
-     * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake ou
-     *                     coupure inattendue de la connexion ;
+     * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ; émis de nouveau quand une
+     *                     écoute `postgres_changes` perdue (voir `CHANNEL_ERROR`) est rétablie ;
+     * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake, coupure
+     *                     inattendue de la connexion, ou écoute `postgres_changes` du projet
+     *                     perdue (l'abonnement est conservé, `SUBSCRIBED` suit sa reprise) ;
      * - `TIMED_OUT`     — aucune réponse du serveur dans `timeoutMs` après l'envoi ;
      * - `CLOSED`        — le canal a été fermé volontairement (`unsubscribe()`,
      *                     `removeChannel()`, `removeAllChannels()`, `disconnect()`).

package/dist/index.d.ts

@@ -56,6 +56,7 @@ declare const DEFAULT_SUBSCRIBE_TIMEOUT_MS = 10000;
  * ```
  */
 declare class AuraChannel {
+    /** Nom du canal tel que passé à `realtime.channel(name)`. */
     readonly name: string;
     private readonly _projectPrefix;
     private readonly _listeners;
@@ -108,6 +109,16 @@ declare class AuraChannel {
     private _nextRef;
     /** Full channel name with project prefix (for server protocol) */
     get fullName(): string;
+    /**
+     * Le nom de canal porté par un message serveur désigne-t-il CE canal ?
+     *
+     * Le serveur nomme toujours le canal qualifié `<project_id>:<nom>`. Quand le SDK connaît le
+     * projet (session), `fullName` est déjà qualifié : égalité stricte. Sans session (clé API seule),
+     * le SDK émet le canal nu et la passerelle le qualifie : on retire alors exactement UN segment
+     * de projet (sans `:`) devant le nom. Un nom qui ne fait que se terminer par `:<nom>`
+     * (`<pid>:x:<nom>`) désigne un AUTRE canal.
+     */
+    _isOwnServerChannel(serverChannel: string): boolean;
     /**
      * Enregistre un listener pour les événements PostgreSQL (CDC) avec filtrage INSERT.
      * Typé spécifiquement avec `new: TRow` et `old: null`.
@@ -117,14 +128,16 @@ declare class AuraChannel {
     }, 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>`.
+     * Typé spécifiquement avec `new: TRow` et `old: Partial<TRow>` : `old` ne porte que
+     * la clé primaire de l'ancienne ligne, jamais ses autres valeurs.
      */
     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`.
+     * Typé spécifiquement avec `new: null` et `old: Partial<TRow> | null` : `old` ne porte
+     * que la clé primaire de la ligne supprimée.
      */
     on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & {
         event: 'DELETE';
@@ -157,9 +170,11 @@ declare class AuraChannel {
      * with the full config (postgres_changes, broadcast, presence).
      *
      * Le callback reçoit les mêmes statuts que `@supabase/realtime-js` :
-     * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ;
-     * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake ou
-     *                     coupure inattendue de la connexion ;
+     * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ; émis de nouveau quand une
+     *                     écoute `postgres_changes` perdue (voir `CHANNEL_ERROR`) est rétablie ;
+     * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake, coupure
+     *                     inattendue de la connexion, ou écoute `postgres_changes` du projet
+     *                     perdue (l'abonnement est conservé, `SUBSCRIBED` suit sa reprise) ;
      * - `TIMED_OUT`     — aucune réponse du serveur dans `timeoutMs` après l'envoi ;
      * - `CLOSED`        — le canal a été fermé volontairement (`unsubscribe()`,
      *                     `removeChannel()`, `removeAllChannels()`, `disconnect()`).

package/dist/index.js

@@ -221,6 +221,7 @@ function matchesColumnFilter(filter, record) {
 var DEFAULT_SUBSCRIBE_TIMEOUT_MS = 1e4;
 var PERTE_D_ABONNEMENT = /Non abonné au canal|Accès révoqué au channel/;
 var AuraChannel = class {
+  /** Nom du canal tel que passé à `realtime.channel(name)`. */
   name;
   _projectPrefix;
   _listeners = [];
@@ -286,6 +287,21 @@ var AuraChannel = class {
   get fullName() {
     return `${this._projectPrefix()}${this.name}`;
   }
+  /**
+   * Le nom de canal porté par un message serveur désigne-t-il CE canal ?
+   *
+   * Le serveur nomme toujours le canal qualifié `<project_id>:<nom>`. Quand le SDK connaît le
+   * projet (session), `fullName` est déjà qualifié : égalité stricte. Sans session (clé API seule),
+   * le SDK émet le canal nu et la passerelle le qualifie : on retire alors exactement UN segment
+   * de projet (sans `:`) devant le nom. Un nom qui ne fait que se terminer par `:<nom>`
+   * (`<pid>:x:<nom>`) désigne un AUTRE canal.
+   */
+  _isOwnServerChannel(serverChannel) {
+    if (serverChannel === this.fullName || serverChannel === this.name) return true;
+    if (this.fullName !== this.name) return false;
+    const sep = serverChannel.indexOf(":");
+    return sep > 0 && serverChannel.slice(sep + 1) === 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.
@@ -357,9 +373,11 @@ var AuraChannel = class {
    * with the full config (postgres_changes, broadcast, presence).
    *
    * Le callback reçoit les mêmes statuts que `@supabase/realtime-js` :
-   * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ;
-   * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake ou
-   *                     coupure inattendue de la connexion ;
+   * - `SUBSCRIBED`    — le serveur a confirmé l'abonnement ; émis de nouveau quand une
+   *                     écoute `postgres_changes` perdue (voir `CHANNEL_ERROR`) est rétablie ;
+   * - `CHANNEL_ERROR` — refus serveur (RLS, rate limit…), échec de handshake, coupure
+   *                     inattendue de la connexion, ou écoute `postgres_changes` du projet
+   *                     perdue (l'abonnement est conservé, `SUBSCRIBED` suit sa reprise) ;
    * - `TIMED_OUT`     — aucune réponse du serveur dans `timeoutMs` après l'envoi ;
    * - `CLOSED`        — le canal a été fermé volontairement (`unsubscribe()`,
    *                     `removeChannel()`, `removeAllChannels()`, `disconnect()`).
@@ -508,6 +526,10 @@ var AuraChannel = class {
    */
   send(message) {
     return new Promise((resolve) => {
+      if (message.payload && Object.prototype.hasOwnProperty.call(message.payload, "event")) {
+        resolve("invalid_payload");
+        return;
+      }
       if (!this._sendFn) {
         resolve("not_connected");
         return;
@@ -640,7 +662,7 @@ var AuraChannel = class {
       case "error": {
         const errMsg = msg;
         const errChannel = errMsg.channel;
-        if (errChannel && errChannel !== this.fullName && errChannel !== this.name) {
+        if (errChannel && !this._isOwnServerChannel(errChannel)) {
           break;
         }
         this._clearSubscribeTimeout();
@@ -653,6 +675,12 @@ var AuraChannel = class {
         }
         break;
       }
+      case "channel_recovered": {
+        if (!this._isOwnServerChannel(msg.channel)) break;
+        if (this._serverState !== "subscribed") break;
+        this._emitStatus("SUBSCRIBED");
+        break;
+      }
       case "token_refreshed":
         break;
       case "broadcast_ack": {
@@ -1471,6 +1499,17 @@ var RealtimeService = class _RealtimeService {
    * - ou déjà qualifié (`'<project_id>:room-1'`).
    */
   httpBroadcast(channel, event, payload = {}, options) {
+    if (Object.prototype.hasOwnProperty.call(payload, "event")) {
+      return Promise.resolve({
+        data: null,
+        error: new AuraError(0, {
+          error: {
+            code: "realtime_payload_event_reserved",
+            message: "httpBroadcast: le payload contient une cl\xE9 `event`, r\xE9serv\xE9e au nom de l'\xE9v\xE9nement (elle \xE9craserait celui-ci chez les abonn\xE9s). Renommez-la (`eventName`, `kind`\u2026)."
+          }
+        })
+      });
+    }
     const explicitProjectId = options?.projectId ?? this.client.projectId;
     let prefix = this._projectPrefix();
     if (!prefix && explicitProjectId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/realtime",
-  "version": "0.5.4",
+  "version": "0.6.1",
   "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.4"
+    "@aurabase/core": "0.6.1"
   },
   "devDependencies": {
     "@types/node": "20.14.15",