@aurabase/realtime 0.6.1 → 0.7.0

package/dist/index.cjs

@@ -309,6 +309,11 @@ var AuraChannel = class {
    * Retourne une fonction de désabonnement direct `() => void` qui proxy également l'instance du canal pour le chaînage fluide.
    */
   on(type, filter, callback) {
+    if (type !== "postgres_changes" && type !== "broadcast" && type !== "presence") {
+      throw new TypeError(
+        `[aurabase] channel.on(): unknown listen type "${String(type)}". For table changes use .on('postgres_changes', { event: 'INSERT', schema: 'public', table: '<table>' }, callback); other types: 'broadcast', 'presence'.`
+      );
+    }
     const id = ++this._listenerIdCounter;
     this._listeners.push({
       id,
@@ -892,6 +897,9 @@ var RealtimeConnectionError = class _RealtimeConnectionError extends Error {
 };
 
 // src/HeartbeatManager.ts
+function isUnrefable(value) {
+  return typeof value === "object" && value !== null && "unref" in value && typeof value.unref === "function";
+}
 var HeartbeatManager = class _HeartbeatManager {
   _worker = null;
   _workerUrl = null;
@@ -962,6 +970,9 @@ var HeartbeatManager = class _HeartbeatManager {
     this._interval = setInterval(() => {
       this._sendFn?.();
     }, intervalMs);
+    if (isUnrefable(this._interval)) {
+      this._interval.unref();
+    }
   }
   _clearWatchdog() {
     if (this._watchdog) {
@@ -1044,6 +1055,9 @@ function getTokenProjectId(token) {
 var HEARTBEAT_INTERVAL_MS = 25e3;
 var MAX_TIMEOUT_MS = 2147483647;
 var LIVENESS_GUARD_INTERVAL_MS = 3e4;
+function isUnrefable2(value) {
+  return typeof value === "object" && value !== null && "unref" in value && typeof value.unref === "function";
+}
 var CANAL_QUALIFIE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}:/;
 var LIVENESS_MAX_SILENCE_MS = 9e4;
 var RealtimeService = class _RealtimeService {
@@ -1243,11 +1257,11 @@ var RealtimeService = class _RealtimeService {
         this._emitError(
           opened ? new RealtimeConnectionError(
             "connection",
-            "Realtime : connexion WebSocket ferm\xE9e de fa\xE7on inattendue.",
+            "Realtime: WebSocket connection closed unexpectedly.",
             { code: evt?.code, reason: evt?.reason }
           ) : new RealtimeConnectionError(
             "handshake",
-            "Realtime : \xE9chec du handshake WebSocket (ferm\xE9 avant ouverture). Causes possibles, par ordre de fr\xE9quence : authentification refus\xE9e (HTTP 401/403 \u2014 token JWT absent, expir\xE9 ou invalide, apikey rejet\xE9e), quota de connexions atteint (HTTP 429), ou serveur injoignable / en red\xE9marrage / bloqu\xE9 par un proxy ou TLS. La sp\xE9cification WebSocket n'expose pas le statut HTTP du handshake au client : le SDK ne peut pas trancher entre ces causes.",
+            "Realtime: WebSocket handshake failed (closed before opening). Possible causes, in order of likelihood: authentication refused (HTTP 401/403: JWT missing, expired or invalid, apikey rejected), connection quota reached (HTTP 429), or server unreachable / restarting / blocked by a proxy or TLS. The WebSocket specification does not expose the handshake HTTP status to the client: the SDK cannot tell these causes apart.",
             { code: evt?.code ?? 1006, reason: evt?.reason }
           )
         );
@@ -1295,9 +1309,12 @@ var RealtimeService = class _RealtimeService {
       const silence = Date.now() - this._lastServerMessageAt;
       if (silence < LIVENESS_MAX_SILENCE_MS) return;
       this._handleDeadConnection(
-        `Realtime : aucun message du serveur depuis ${Math.round(silence / 1e3)} s alors qu'il en pousse un toutes les 30 s \u2014 connexion consid\xE9r\xE9e morte. Reconnexion.`
+        `Realtime: no message from the server for ${Math.round(silence / 1e3)} s although it pushes one every 30 s: the connection is considered dead. Reconnecting.`
       );
     }, LIVENESS_GUARD_INTERVAL_MS);
+    if (isUnrefable2(this._livenessGuard)) {
+      this._livenessGuard.unref();
+    }
   }
   _stopLivenessGuard() {
     if (this._livenessGuard) {
@@ -1347,13 +1364,13 @@ var RealtimeService = class _RealtimeService {
     if (ws !== this._ws) return;
     if (ws.readyState !== WebSocket.OPEN) {
       this._handleDeadConnection(
-        "Realtime : la connexion WebSocket n\u2019est plus ouverte mais aucun \xE9v\xE9nement de fermeture n\u2019est arriv\xE9 (socket fig\xE9). Reconnexion."
+        "Realtime: the WebSocket connection is no longer open but no close event arrived (stuck socket). Reconnecting."
       );
       return;
     }
     if (this._awaitingPong) {
       this._handleDeadConnection(
-        `Realtime : connexion inactive \u2014 aucune r\xE9ponse du serveur dans les ${HEARTBEAT_INTERVAL_MS} ms suivant un ping (connexion probablement morte). Reconnexion.`
+        `Realtime: idle connection, no server response within ${HEARTBEAT_INTERVAL_MS} ms after a ping (connection probably dead). Reconnecting.`
       );
       return;
     }
@@ -1507,7 +1524,7 @@ var RealtimeService = class _RealtimeService {
         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)."
+            message: "httpBroadcast: the payload contains an `event` key, which is reserved for the event name (it would overwrite it for subscribers). Rename it (`eventName`, `kind`\u2026)."
           }
         })
       });
@@ -1528,7 +1545,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 + `" 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.`
+            message: `httpBroadcast: the channel "${channel}" is not qualified and no session is open, so the SDK has no \`project_id\` to prefix it with, while the server REQUIRES it (403 "The channel does not belong to this project"). Pass the channel as "<project_id>:` + channel + '" or specify the option { projectId: "<uuid>" }, which is the expected form server-side/edge, where there is no user session.'
           }
         })
       });
@@ -1694,7 +1711,7 @@ var RealtimeService = class _RealtimeService {
       if (msg.type === "error") {
         if (typeof console !== "undefined") {
           console.warn(
-            "[aura-realtime] Erreur serveur pour un canal inconnu de ce client \u2014 ignor\xE9e (aucun canal local concern\xE9) :",
+            "[aura-realtime] Server error for a channel unknown to this client: ignored (no local channel concerned):",
             { channel: channelFull, message: msg.message }
           );
         }
@@ -1731,6 +1748,11 @@ var RealtimeService = class _RealtimeService {
       for (const ch of this._channels.values()) {
         ch._onMessage(msg);
       }
+      const text = msg.message ?? "";
+      if (text.startsWith("SESSION_REVOKED") && !this._customAuthToken) {
+        this._reconnectAttempts = this._maxReconnectAttempts;
+        this.client.authStore.clear();
+      }
     }
   }
 };

package/dist/index.d.cts

@@ -354,7 +354,6 @@ declare class RealtimeConnectionError extends Error {
  * Le chien de garde porte sur le `ready`, PAS sur le premier battement : mesuré
  * en Chromium réel, le démarrage d'un Worker peut dépasser 1,5 intervalle quand
  * l'intervalle est court, ce qui faisait abandonner à tort un Worker
- * parfaitement sain — et perdre silencieusement l'immunité au throttling, la
  * seule raison d'être de ce Worker.
  */
 declare class HeartbeatManager {

package/dist/index.d.ts

@@ -354,7 +354,6 @@ declare class RealtimeConnectionError extends Error {
  * Le chien de garde porte sur le `ready`, PAS sur le premier battement : mesuré
  * en Chromium réel, le démarrage d'un Worker peut dépasser 1,5 intervalle quand
  * l'intervalle est court, ce qui faisait abandonner à tort un Worker
- * parfaitement sain — et perdre silencieusement l'immunité au throttling, la
  * seule raison d'être de ce Worker.
  */
 declare class HeartbeatManager {

package/dist/index.js

@@ -307,6 +307,11 @@ var AuraChannel = class {
    * Retourne une fonction de désabonnement direct `() => void` qui proxy également l'instance du canal pour le chaînage fluide.
    */
   on(type, filter, callback) {
+    if (type !== "postgres_changes" && type !== "broadcast" && type !== "presence") {
+      throw new TypeError(
+        `[aurabase] channel.on(): unknown listen type "${String(type)}". For table changes use .on('postgres_changes', { event: 'INSERT', schema: 'public', table: '<table>' }, callback); other types: 'broadcast', 'presence'.`
+      );
+    }
     const id = ++this._listenerIdCounter;
     this._listeners.push({
       id,
@@ -890,6 +895,9 @@ var RealtimeConnectionError = class _RealtimeConnectionError extends Error {
 };
 
 // src/HeartbeatManager.ts
+function isUnrefable(value) {
+  return typeof value === "object" && value !== null && "unref" in value && typeof value.unref === "function";
+}
 var HeartbeatManager = class _HeartbeatManager {
   _worker = null;
   _workerUrl = null;
@@ -960,6 +968,9 @@ var HeartbeatManager = class _HeartbeatManager {
     this._interval = setInterval(() => {
       this._sendFn?.();
     }, intervalMs);
+    if (isUnrefable(this._interval)) {
+      this._interval.unref();
+    }
   }
   _clearWatchdog() {
     if (this._watchdog) {
@@ -1042,6 +1053,9 @@ function getTokenProjectId(token) {
 var HEARTBEAT_INTERVAL_MS = 25e3;
 var MAX_TIMEOUT_MS = 2147483647;
 var LIVENESS_GUARD_INTERVAL_MS = 3e4;
+function isUnrefable2(value) {
+  return typeof value === "object" && value !== null && "unref" in value && typeof value.unref === "function";
+}
 var CANAL_QUALIFIE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}:/;
 var LIVENESS_MAX_SILENCE_MS = 9e4;
 var RealtimeService = class _RealtimeService {
@@ -1241,11 +1255,11 @@ var RealtimeService = class _RealtimeService {
         this._emitError(
           opened ? new RealtimeConnectionError(
             "connection",
-            "Realtime : connexion WebSocket ferm\xE9e de fa\xE7on inattendue.",
+            "Realtime: WebSocket connection closed unexpectedly.",
             { code: evt?.code, reason: evt?.reason }
           ) : new RealtimeConnectionError(
             "handshake",
-            "Realtime : \xE9chec du handshake WebSocket (ferm\xE9 avant ouverture). Causes possibles, par ordre de fr\xE9quence : authentification refus\xE9e (HTTP 401/403 \u2014 token JWT absent, expir\xE9 ou invalide, apikey rejet\xE9e), quota de connexions atteint (HTTP 429), ou serveur injoignable / en red\xE9marrage / bloqu\xE9 par un proxy ou TLS. La sp\xE9cification WebSocket n'expose pas le statut HTTP du handshake au client : le SDK ne peut pas trancher entre ces causes.",
+            "Realtime: WebSocket handshake failed (closed before opening). Possible causes, in order of likelihood: authentication refused (HTTP 401/403: JWT missing, expired or invalid, apikey rejected), connection quota reached (HTTP 429), or server unreachable / restarting / blocked by a proxy or TLS. The WebSocket specification does not expose the handshake HTTP status to the client: the SDK cannot tell these causes apart.",
             { code: evt?.code ?? 1006, reason: evt?.reason }
           )
         );
@@ -1293,9 +1307,12 @@ var RealtimeService = class _RealtimeService {
       const silence = Date.now() - this._lastServerMessageAt;
       if (silence < LIVENESS_MAX_SILENCE_MS) return;
       this._handleDeadConnection(
-        `Realtime : aucun message du serveur depuis ${Math.round(silence / 1e3)} s alors qu'il en pousse un toutes les 30 s \u2014 connexion consid\xE9r\xE9e morte. Reconnexion.`
+        `Realtime: no message from the server for ${Math.round(silence / 1e3)} s although it pushes one every 30 s: the connection is considered dead. Reconnecting.`
       );
     }, LIVENESS_GUARD_INTERVAL_MS);
+    if (isUnrefable2(this._livenessGuard)) {
+      this._livenessGuard.unref();
+    }
   }
   _stopLivenessGuard() {
     if (this._livenessGuard) {
@@ -1345,13 +1362,13 @@ var RealtimeService = class _RealtimeService {
     if (ws !== this._ws) return;
     if (ws.readyState !== WebSocket.OPEN) {
       this._handleDeadConnection(
-        "Realtime : la connexion WebSocket n\u2019est plus ouverte mais aucun \xE9v\xE9nement de fermeture n\u2019est arriv\xE9 (socket fig\xE9). Reconnexion."
+        "Realtime: the WebSocket connection is no longer open but no close event arrived (stuck socket). Reconnecting."
       );
       return;
     }
     if (this._awaitingPong) {
       this._handleDeadConnection(
-        `Realtime : connexion inactive \u2014 aucune r\xE9ponse du serveur dans les ${HEARTBEAT_INTERVAL_MS} ms suivant un ping (connexion probablement morte). Reconnexion.`
+        `Realtime: idle connection, no server response within ${HEARTBEAT_INTERVAL_MS} ms after a ping (connection probably dead). Reconnecting.`
       );
       return;
     }
@@ -1505,7 +1522,7 @@ var RealtimeService = class _RealtimeService {
         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)."
+            message: "httpBroadcast: the payload contains an `event` key, which is reserved for the event name (it would overwrite it for subscribers). Rename it (`eventName`, `kind`\u2026)."
           }
         })
       });
@@ -1526,7 +1543,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 + `" 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.`
+            message: `httpBroadcast: the channel "${channel}" is not qualified and no session is open, so the SDK has no \`project_id\` to prefix it with, while the server REQUIRES it (403 "The channel does not belong to this project"). Pass the channel as "<project_id>:` + channel + '" or specify the option { projectId: "<uuid>" }, which is the expected form server-side/edge, where there is no user session.'
           }
         })
       });
@@ -1692,7 +1709,7 @@ var RealtimeService = class _RealtimeService {
       if (msg.type === "error") {
         if (typeof console !== "undefined") {
           console.warn(
-            "[aura-realtime] Erreur serveur pour un canal inconnu de ce client \u2014 ignor\xE9e (aucun canal local concern\xE9) :",
+            "[aura-realtime] Server error for a channel unknown to this client: ignored (no local channel concerned):",
             { channel: channelFull, message: msg.message }
           );
         }
@@ -1729,6 +1746,11 @@ var RealtimeService = class _RealtimeService {
       for (const ch of this._channels.values()) {
         ch._onMessage(msg);
       }
+      const text = msg.message ?? "";
+      if (text.startsWith("SESSION_REVOKED") && !this._customAuthToken) {
+        this._reconnectAttempts = this._maxReconnectAttempts;
+        this.client.authStore.clear();
+      }
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/realtime",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Service temps réel du SDK Aurabase (postgres_changes, broadcast, presence)",
   "type": "module",
   "main": "dist/index.cjs",
@@ -31,12 +31,12 @@
   "author": "Aurabase",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/daylami555/aurabase.git",
+    "url": "git+https://github.com/Aurabase-cloud/Aurabase.git",
     "directory": "aurabase-js/packages/realtime"
   },
   "homepage": "https://aurabase.cloud",
   "bugs": {
-    "url": "https://github.com/daylami555/aurabase/issues"
+    "url": "https://github.com/Aurabase-cloud/Aurabase/issues"
   },
   "keywords": [
     "aurabase",
@@ -45,7 +45,7 @@
     "realtime"
   ],
   "dependencies": {
-    "@aurabase/core": "0.6.1"
+    "@aurabase/core": "0.7.0"
   },
   "devDependencies": {
     "@types/node": "20.14.15",