@aerostack/sdk-node 0.6.5 → 0.6.7

package/dist/commonjs/sdk/realtime.d.ts

@@ -1,41 +1,50 @@
 /**
  * Aerostack Realtime Client for Node.js SDK
- * Provides WebSocket-based real-time data subscription for server-side usage.
- *
- * This is NOT auto-generated — it is a hand-written extension for the Node SDK.
+ * Production-hardened WebSocket client for server-side usage.
  */
-type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
-interface RealtimeSubscriptionOptions {
+export type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+export interface RealtimeMessage {
+    type: string;
+    topic: string;
+    [key: string]: any;
+}
+export interface RealtimeSubscriptionOptions {
     event?: RealtimeEvent;
     filter?: Record<string, any>;
 }
-type RealtimeCallback = (payload: any) => void;
-interface NodeRealtimeOptions {
-    /** Base API URL (e.g. https://api.aerostack.ai/v1) */
+export type RealtimeCallback<T = any> = (payload: RealtimePayload<T>) => void;
+export interface RealtimePayload<T = any> {
+    type: 'db_change' | 'chat_message';
+    topic: string;
+    operation: RealtimeEvent;
+    data: T;
+    old?: T;
+    timestamp?: string;
+    [key: string]: any;
+}
+export interface NodeRealtimeOptions {
     serverUrl: string;
-    /** Project ID to subscribe to */
     projectId: string;
-    /** API Key for authentication (recommended for server-side) */
     apiKey?: string | undefined;
-    /** User ID (optional) */
     userId?: string | undefined;
-    /** Bearer token (optional, for user-context connections) */
     token?: string | undefined;
+    maxReconnectAttempts?: number;
 }
-export declare class RealtimeSubscription {
+export declare class RealtimeSubscription<T = any> {
     private client;
     private topic;
     private options;
     private callbacks;
     private _isSubscribed;
     constructor(client: NodeRealtimeClient, topic: string, options?: RealtimeSubscriptionOptions);
-    on(_event: RealtimeEvent, callback: RealtimeCallback): this;
+    on(event: RealtimeEvent, callback: RealtimeCallback<T>): this;
     subscribe(): this;
     unsubscribe(): void;
     get isSubscribed(): boolean;
     /** @internal */
-    _emit(payload: any): void;
+    _emit(payload: RealtimePayload<T>): void;
 }
+export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
 export declare class NodeRealtimeClient {
     private wsUrl;
     private projectId;
@@ -47,20 +56,32 @@ export declare class NodeRealtimeClient {
     private reconnectTimer;
     private heartbeatTimer;
     private reconnectAttempts;
-    private _connected;
+    private _sendQueue;
+    private _connectingPromise;
+    private _status;
+    private _statusListeners;
+    private _lastPong;
+    private _maxReconnectAttempts;
+    private _maxRetriesListeners;
     constructor(options: NodeRealtimeOptions);
+    get status(): RealtimeStatus;
     get connected(): boolean;
+    onStatusChange(cb: (status: RealtimeStatus) => void): () => void;
+    onMaxRetriesExceeded(cb: () => void): () => void;
+    private _setStatus;
+    setToken(newToken: string): void;
     connect(): Promise<void>;
+    private _doConnect;
     disconnect(): void;
-    channel(topic: string, options?: RealtimeSubscriptionOptions): RealtimeSubscription;
+    channel<T = any>(topic: string, options?: RealtimeSubscriptionOptions): RealtimeSubscription<T>;
+    sendChat(roomId: string, text: string): void;
+    chatRoom(roomId: string): RealtimeSubscription;
     /** @internal */
     _send(data: any): void;
     private handleMessage;
     private startHeartbeat;
     private stopHeartbeat;
-    /** Exponential backoff with jitter */
     private scheduleReconnect;
     private stopReconnect;
 }
-export {};
 //# sourceMappingURL=realtime.d.ts.map

package/dist/commonjs/sdk/realtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAC;AAQ1D,UAAU,2BAA2B;IACjC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,KAAK,gBAAgB,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;AAE/C,UAAU,mBAAmB;IACzB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAOD,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,aAAa,CAAkB;gBAE3B,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC;IAMhG,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAK3D,SAAS,IAAI,IAAI;IAWjB,WAAW,IAAI,IAAI;IAUnB,IAAI,YAAY,YAAiC;IAEjD,gBAAgB;IAChB,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;CAc5B;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,UAAU,CAAkB;gBAExB,OAAO,EAAE,mBAAmB;IAUxC,IAAI,SAAS,IAAI,OAAO,CAA4B;IAE9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE9B,UAAU,IAAI,IAAI;IAUlB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,oBAAoB;IAWvF,gBAAgB;IAChB,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAMtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAOrB,sCAAsC;IACtC,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,aAAa;CAMxB"}
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/sdk/realtime.js

@@ -1,26 +1,26 @@
 "use strict";
 /**
  * Aerostack Realtime Client for Node.js SDK
- * Provides WebSocket-based real-time data subscription for server-side usage.
- *
- * This is NOT auto-generated — it is a hand-written extension for the Node SDK.
+ * Production-hardened WebSocket client for server-side usage.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeRealtimeClient = exports.RealtimeSubscription = void 0;
-// Constants for exponential backoff
 const BASE_RECONNECT_MS = 1000;
 const MAX_RECONNECT_MS = 30000;
 const JITTER_FACTOR = 0.3;
 class RealtimeSubscription {
     constructor(client, topic, options = {}) {
-        this.callbacks = new Set();
+        this.callbacks = new Map();
         this._isSubscribed = false;
         this.client = client;
         this.topic = topic;
         this.options = options;
     }
-    on(_event, callback) {
-        this.callbacks.add(callback);
+    on(event, callback) {
+        if (!this.callbacks.has(event)) {
+            this.callbacks.set(event, new Set());
+        }
+        this.callbacks.get(event).add(callback);
         return this;
     }
     subscribe() {
@@ -48,41 +48,76 @@ class RealtimeSubscription {
     /** @internal */
     _emit(payload) {
         const event = payload.operation;
-        const requestedEvent = this.options.event || '*';
-        if (requestedEvent === '*' || requestedEvent === event) {
-            for (const cb of this.callbacks) {
-                try {
-                    cb(payload);
-                }
-                catch (e) {
-                    console.error('Realtime callback error:', e);
-                }
+        this.callbacks.get(event)?.forEach(cb => {
+            try {
+                cb(payload);
             }
-        }
+            catch (e) {
+                console.error('Realtime callback error:', e);
+            }
+        });
+        this.callbacks.get('*')?.forEach(cb => {
+            try {
+                cb(payload);
+            }
+            catch (e) {
+                console.error('Realtime callback error:', e);
+            }
+        });
     }
 }
 exports.RealtimeSubscription = RealtimeSubscription;
 class NodeRealtimeClient {
     constructor(options) {
-        this.ws = null; // WebSocket instance (from 'ws' or global)
+        this.ws = null;
         this.subscriptions = new Map();
         this.reconnectTimer = null;
         this.heartbeatTimer = null;
         this.reconnectAttempts = 0;
-        this._connected = false;
-        // Convert HTTP URL to WS URL
+        this._sendQueue = [];
+        this._connectingPromise = null;
+        this._status = 'idle';
+        this._statusListeners = new Set();
+        this._lastPong = 0;
+        this._maxRetriesListeners = new Set();
         const base = options.serverUrl.replace(/\/v1\/?$/, '').replace(/^http/, 'ws');
         this.wsUrl = `${base}/api/realtime`;
         this.projectId = options.projectId;
         this.apiKey = options.apiKey;
         this.userId = options.userId;
         this.token = options.token;
+        this._maxReconnectAttempts = options.maxReconnectAttempts ?? Infinity;
+    }
+    get status() { return this._status; }
+    get connected() { return this._status === 'connected'; }
+    onStatusChange(cb) {
+        this._statusListeners.add(cb);
+        return () => this._statusListeners.delete(cb);
+    }
+    onMaxRetriesExceeded(cb) {
+        this._maxRetriesListeners.add(cb);
+        return () => this._maxRetriesListeners.delete(cb);
+    }
+    _setStatus(s) {
+        this._status = s;
+        this._statusListeners.forEach(cb => cb(s));
+    }
+    setToken(newToken) {
+        this.token = newToken;
+        this._send({ type: 'auth', token: newToken });
     }
-    get connected() { return this._connected; }
     async connect() {
-        if (this.ws)
+        if (this.ws && this._status === 'connected')
             return;
-        // Build URL with query params
+        if (this._connectingPromise)
+            return this._connectingPromise;
+        this._connectingPromise = this._doConnect().finally(() => {
+            this._connectingPromise = null;
+        });
+        return this._connectingPromise;
+    }
+    async _doConnect() {
+        this._setStatus('connecting');
         const url = new URL(this.wsUrl);
         if (this.apiKey) {
             url.searchParams.set('apiKey', this.apiKey);
@@ -96,8 +131,6 @@ class NodeRealtimeClient {
             url.searchParams.set('token', this.token);
         return new Promise(async (resolve, reject) => {
             try {
-                // Try native WebSocket first (Bun, Deno, modern Node 22+)
-                // Fall back to 'ws' package for older Node versions
                 let WsClass;
                 if (typeof globalThis.WebSocket !== 'undefined') {
                     WsClass = globalThis.WebSocket;
@@ -108,15 +141,18 @@ class NodeRealtimeClient {
                         WsClass = ws.default || ws;
                     }
                     catch {
-                        throw new Error('WebSocket not available. Install the "ws" package: npm install ws');
+                        throw new Error('WebSocket not available. Install "ws" package.');
                     }
                 }
                 this.ws = new WsClass(url.toString());
                 this.ws.onopen = () => {
-                    this._connected = true;
-                    this.reconnectAttempts = 0; // Reset backoff on success
+                    this._setStatus('connected');
+                    this.reconnectAttempts = 0;
+                    this._lastPong = Date.now();
                     this.startHeartbeat();
-                    // Re-subscribe existing topics
+                    while (this._sendQueue.length > 0) {
+                        this.ws.send(JSON.stringify(this._sendQueue.shift()));
+                    }
                     for (const sub of this.subscriptions.values()) {
                         if (sub.isSubscribed)
                             sub.subscribe();
@@ -134,30 +170,32 @@ class NodeRealtimeClient {
                     }
                 };
                 this.ws.onclose = () => {
-                    this._connected = false;
+                    this._setStatus('reconnecting');
                     this.stopHeartbeat();
                     this.ws = null;
                     this.scheduleReconnect();
                 };
                 this.ws.onerror = (err) => {
-                    if (!this._connected) {
-                        reject(err);
-                    }
+                    console.error('Realtime connection error:', err);
+                    this._setStatus('disconnected');
+                    reject(err);
                 };
             }
             catch (e) {
+                this._setStatus('disconnected');
                 reject(e);
             }
         });
     }
     disconnect() {
+        this._setStatus('disconnected');
         this.stopReconnect();
         this.stopHeartbeat();
         if (this.ws) {
             this.ws.close();
             this.ws = null;
         }
-        this._connected = false;
+        this._sendQueue = [];
     }
     channel(topic, options = {}) {
         const fullTopic = topic.includes('/') ? topic : `table/${topic}/${this.projectId}`;
@@ -168,13 +206,26 @@ class NodeRealtimeClient {
         }
         return sub;
     }
+    sendChat(roomId, text) {
+        this._send({ type: 'chat', roomId, text });
+    }
+    chatRoom(roomId) {
+        return this.channel(`chat/${roomId}/${this.projectId}`);
+    }
     /** @internal */
     _send(data) {
-        if (this.ws && this._connected) {
+        if (this.ws && this._status === 'connected') {
             this.ws.send(JSON.stringify(data));
         }
+        else {
+            this._sendQueue.push(data);
+        }
     }
     handleMessage(data) {
+        if (data.type === 'pong') {
+            this._lastPong = Date.now();
+            return;
+        }
         if (data.type === 'db_change' || data.type === 'chat_message') {
             const sub = this.subscriptions.get(data.topic);
             if (sub)
@@ -184,6 +235,10 @@ class NodeRealtimeClient {
     startHeartbeat() {
         this.heartbeatTimer = setInterval(() => {
             this._send({ type: 'ping' });
+            if (this._lastPong > 0 && Date.now() - this._lastPong > 70000) {
+                console.warn('Realtime: no pong received, forcing reconnect');
+                this.ws?.close();
+            }
         }, 30000);
     }
     stopHeartbeat() {
@@ -192,16 +247,19 @@ class NodeRealtimeClient {
             this.heartbeatTimer = null;
         }
     }
-    /** Exponential backoff with jitter */
     scheduleReconnect() {
         this.stopReconnect();
+        if (this.reconnectAttempts >= this._maxReconnectAttempts) {
+            this._setStatus('disconnected');
+            this._maxRetriesListeners.forEach(cb => cb());
+            return;
+        }
         const delay = Math.min(BASE_RECONNECT_MS * Math.pow(2, this.reconnectAttempts), MAX_RECONNECT_MS);
         const jitter = delay * JITTER_FACTOR * Math.random();
-        const finalDelay = delay + jitter;
         this.reconnectAttempts++;
         this.reconnectTimer = setTimeout(() => {
             this.connect().catch(() => { });
-        }, finalDelay);
+        }, delay + jitter);
     }
     stopReconnect() {
         if (this.reconnectTimer) {

package/dist/commonjs/sdk/realtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"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"}

package/dist/esm/sdk/realtime.d.ts

@@ -1,41 +1,50 @@
 /**
  * Aerostack Realtime Client for Node.js SDK
- * Provides WebSocket-based real-time data subscription for server-side usage.
- *
- * This is NOT auto-generated — it is a hand-written extension for the Node SDK.
+ * Production-hardened WebSocket client for server-side usage.
  */
-type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
-interface RealtimeSubscriptionOptions {
+export type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+export interface RealtimeMessage {
+    type: string;
+    topic: string;
+    [key: string]: any;
+}
+export interface RealtimeSubscriptionOptions {
     event?: RealtimeEvent;
     filter?: Record<string, any>;
 }
-type RealtimeCallback = (payload: any) => void;
-interface NodeRealtimeOptions {
-    /** Base API URL (e.g. https://api.aerostack.ai/v1) */
+export type RealtimeCallback<T = any> = (payload: RealtimePayload<T>) => void;
+export interface RealtimePayload<T = any> {
+    type: 'db_change' | 'chat_message';
+    topic: string;
+    operation: RealtimeEvent;
+    data: T;
+    old?: T;
+    timestamp?: string;
+    [key: string]: any;
+}
+export interface NodeRealtimeOptions {
     serverUrl: string;
-    /** Project ID to subscribe to */
     projectId: string;
-    /** API Key for authentication (recommended for server-side) */
     apiKey?: string | undefined;
-    /** User ID (optional) */
     userId?: string | undefined;
-    /** Bearer token (optional, for user-context connections) */
     token?: string | undefined;
+    maxReconnectAttempts?: number;
 }
-export declare class RealtimeSubscription {
+export declare class RealtimeSubscription<T = any> {
     private client;
     private topic;
     private options;
     private callbacks;
     private _isSubscribed;
     constructor(client: NodeRealtimeClient, topic: string, options?: RealtimeSubscriptionOptions);
-    on(_event: RealtimeEvent, callback: RealtimeCallback): this;
+    on(event: RealtimeEvent, callback: RealtimeCallback<T>): this;
     subscribe(): this;
     unsubscribe(): void;
     get isSubscribed(): boolean;
     /** @internal */
-    _emit(payload: any): void;
+    _emit(payload: RealtimePayload<T>): void;
 }
+export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
 export declare class NodeRealtimeClient {
     private wsUrl;
     private projectId;
@@ -47,20 +56,32 @@ export declare class NodeRealtimeClient {
     private reconnectTimer;
     private heartbeatTimer;
     private reconnectAttempts;
-    private _connected;
+    private _sendQueue;
+    private _connectingPromise;
+    private _status;
+    private _statusListeners;
+    private _lastPong;
+    private _maxReconnectAttempts;
+    private _maxRetriesListeners;
     constructor(options: NodeRealtimeOptions);
+    get status(): RealtimeStatus;
     get connected(): boolean;
+    onStatusChange(cb: (status: RealtimeStatus) => void): () => void;
+    onMaxRetriesExceeded(cb: () => void): () => void;
+    private _setStatus;
+    setToken(newToken: string): void;
     connect(): Promise<void>;
+    private _doConnect;
     disconnect(): void;
-    channel(topic: string, options?: RealtimeSubscriptionOptions): RealtimeSubscription;
+    channel<T = any>(topic: string, options?: RealtimeSubscriptionOptions): RealtimeSubscription<T>;
+    sendChat(roomId: string, text: string): void;
+    chatRoom(roomId: string): RealtimeSubscription;
     /** @internal */
     _send(data: any): void;
     private handleMessage;
     private startHeartbeat;
     private stopHeartbeat;
-    /** Exponential backoff with jitter */
     private scheduleReconnect;
     private stopReconnect;
 }
-export {};
 //# sourceMappingURL=realtime.d.ts.map

package/dist/esm/sdk/realtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAC;AAQ1D,UAAU,2BAA2B;IACjC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,KAAK,gBAAgB,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;AAE/C,UAAU,mBAAmB;IACzB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAOD,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,aAAa,CAAkB;gBAE3B,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC;IAMhG,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAK3D,SAAS,IAAI,IAAI;IAWjB,WAAW,IAAI,IAAI;IAUnB,IAAI,YAAY,YAAiC;IAEjD,gBAAgB;IAChB,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;CAc5B;AAED,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,UAAU,CAAkB;gBAExB,OAAO,EAAE,mBAAmB;IAUxC,IAAI,SAAS,IAAI,OAAO,CAA4B;IAE9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE9B,UAAU,IAAI,IAAI;IAUlB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,2BAAgC,GAAG,oBAAoB;IAWvF,gBAAgB;IAChB,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAMtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAOrB,sCAAsC;IACtC,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,aAAa;CAMxB"}
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"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"}

package/dist/esm/sdk/realtime.js

@@ -1,23 +1,23 @@
 /**
  * Aerostack Realtime Client for Node.js SDK
- * Provides WebSocket-based real-time data subscription for server-side usage.
- *
- * This is NOT auto-generated — it is a hand-written extension for the Node SDK.
+ * Production-hardened WebSocket client for server-side usage.
  */
-// Constants for exponential backoff
 const BASE_RECONNECT_MS = 1000;
 const MAX_RECONNECT_MS = 30000;
 const JITTER_FACTOR = 0.3;
 export class RealtimeSubscription {
     constructor(client, topic, options = {}) {
-        this.callbacks = new Set();
+        this.callbacks = new Map();
         this._isSubscribed = false;
         this.client = client;
         this.topic = topic;
         this.options = options;
     }
-    on(_event, callback) {
-        this.callbacks.add(callback);
+    on(event, callback) {
+        if (!this.callbacks.has(event)) {
+            this.callbacks.set(event, new Set());
+        }
+        this.callbacks.get(event).add(callback);
         return this;
     }
     subscribe() {
@@ -45,40 +45,75 @@ export class RealtimeSubscription {
     /** @internal */
     _emit(payload) {
         const event = payload.operation;
-        const requestedEvent = this.options.event || '*';
-        if (requestedEvent === '*' || requestedEvent === event) {
-            for (const cb of this.callbacks) {
-                try {
-                    cb(payload);
-                }
-                catch (e) {
-                    console.error('Realtime callback error:', e);
-                }
+        this.callbacks.get(event)?.forEach(cb => {
+            try {
+                cb(payload);
             }
-        }
+            catch (e) {
+                console.error('Realtime callback error:', e);
+            }
+        });
+        this.callbacks.get('*')?.forEach(cb => {
+            try {
+                cb(payload);
+            }
+            catch (e) {
+                console.error('Realtime callback error:', e);
+            }
+        });
     }
 }
 export class NodeRealtimeClient {
     constructor(options) {
-        this.ws = null; // WebSocket instance (from 'ws' or global)
+        this.ws = null;
         this.subscriptions = new Map();
         this.reconnectTimer = null;
         this.heartbeatTimer = null;
         this.reconnectAttempts = 0;
-        this._connected = false;
-        // Convert HTTP URL to WS URL
+        this._sendQueue = [];
+        this._connectingPromise = null;
+        this._status = 'idle';
+        this._statusListeners = new Set();
+        this._lastPong = 0;
+        this._maxRetriesListeners = new Set();
         const base = options.serverUrl.replace(/\/v1\/?$/, '').replace(/^http/, 'ws');
         this.wsUrl = `${base}/api/realtime`;
         this.projectId = options.projectId;
         this.apiKey = options.apiKey;
         this.userId = options.userId;
         this.token = options.token;
+        this._maxReconnectAttempts = options.maxReconnectAttempts ?? Infinity;
+    }
+    get status() { return this._status; }
+    get connected() { return this._status === 'connected'; }
+    onStatusChange(cb) {
+        this._statusListeners.add(cb);
+        return () => this._statusListeners.delete(cb);
+    }
+    onMaxRetriesExceeded(cb) {
+        this._maxRetriesListeners.add(cb);
+        return () => this._maxRetriesListeners.delete(cb);
+    }
+    _setStatus(s) {
+        this._status = s;
+        this._statusListeners.forEach(cb => cb(s));
+    }
+    setToken(newToken) {
+        this.token = newToken;
+        this._send({ type: 'auth', token: newToken });
     }
-    get connected() { return this._connected; }
     async connect() {
-        if (this.ws)
+        if (this.ws && this._status === 'connected')
             return;
-        // Build URL with query params
+        if (this._connectingPromise)
+            return this._connectingPromise;
+        this._connectingPromise = this._doConnect().finally(() => {
+            this._connectingPromise = null;
+        });
+        return this._connectingPromise;
+    }
+    async _doConnect() {
+        this._setStatus('connecting');
         const url = new URL(this.wsUrl);
         if (this.apiKey) {
             url.searchParams.set('apiKey', this.apiKey);
@@ -92,8 +127,6 @@ export class NodeRealtimeClient {
             url.searchParams.set('token', this.token);
         return new Promise(async (resolve, reject) => {
             try {
-                // Try native WebSocket first (Bun, Deno, modern Node 22+)
-                // Fall back to 'ws' package for older Node versions
                 let WsClass;
                 if (typeof globalThis.WebSocket !== 'undefined') {
                     WsClass = globalThis.WebSocket;
@@ -104,15 +137,18 @@ export class NodeRealtimeClient {
                         WsClass = ws.default || ws;
                     }
                     catch {
-                        throw new Error('WebSocket not available. Install the "ws" package: npm install ws');
+                        throw new Error('WebSocket not available. Install "ws" package.');
                     }
                 }
                 this.ws = new WsClass(url.toString());
                 this.ws.onopen = () => {
-                    this._connected = true;
-                    this.reconnectAttempts = 0; // Reset backoff on success
+                    this._setStatus('connected');
+                    this.reconnectAttempts = 0;
+                    this._lastPong = Date.now();
                     this.startHeartbeat();
-                    // Re-subscribe existing topics
+                    while (this._sendQueue.length > 0) {
+                        this.ws.send(JSON.stringify(this._sendQueue.shift()));
+                    }
                     for (const sub of this.subscriptions.values()) {
                         if (sub.isSubscribed)
                             sub.subscribe();
@@ -130,30 +166,32 @@ export class NodeRealtimeClient {
                     }
                 };
                 this.ws.onclose = () => {
-                    this._connected = false;
+                    this._setStatus('reconnecting');
                     this.stopHeartbeat();
                     this.ws = null;
                     this.scheduleReconnect();
                 };
                 this.ws.onerror = (err) => {
-                    if (!this._connected) {
-                        reject(err);
-                    }
+                    console.error('Realtime connection error:', err);
+                    this._setStatus('disconnected');
+                    reject(err);
                 };
             }
             catch (e) {
+                this._setStatus('disconnected');
                 reject(e);
             }
         });
     }
     disconnect() {
+        this._setStatus('disconnected');
         this.stopReconnect();
         this.stopHeartbeat();
         if (this.ws) {
             this.ws.close();
             this.ws = null;
         }
-        this._connected = false;
+        this._sendQueue = [];
     }
     channel(topic, options = {}) {
         const fullTopic = topic.includes('/') ? topic : `table/${topic}/${this.projectId}`;
@@ -164,13 +202,26 @@ export class NodeRealtimeClient {
         }
         return sub;
     }
+    sendChat(roomId, text) {
+        this._send({ type: 'chat', roomId, text });
+    }
+    chatRoom(roomId) {
+        return this.channel(`chat/${roomId}/${this.projectId}`);
+    }
     /** @internal */
     _send(data) {
-        if (this.ws && this._connected) {
+        if (this.ws && this._status === 'connected') {
             this.ws.send(JSON.stringify(data));
         }
+        else {
+            this._sendQueue.push(data);
+        }
     }
     handleMessage(data) {
+        if (data.type === 'pong') {
+            this._lastPong = Date.now();
+            return;
+        }
         if (data.type === 'db_change' || data.type === 'chat_message') {
             const sub = this.subscriptions.get(data.topic);
             if (sub)
@@ -180,6 +231,10 @@ export class NodeRealtimeClient {
     startHeartbeat() {
         this.heartbeatTimer = setInterval(() => {
             this._send({ type: 'ping' });
+            if (this._lastPong > 0 && Date.now() - this._lastPong > 70000) {
+                console.warn('Realtime: no pong received, forcing reconnect');
+                this.ws?.close();
+            }
         }, 30000);
     }
     stopHeartbeat() {
@@ -188,16 +243,19 @@ export class NodeRealtimeClient {
             this.heartbeatTimer = null;
         }
     }
-    /** Exponential backoff with jitter */
     scheduleReconnect() {
         this.stopReconnect();
+        if (this.reconnectAttempts >= this._maxReconnectAttempts) {
+            this._setStatus('disconnected');
+            this._maxRetriesListeners.forEach(cb => cb());
+            return;
+        }
         const delay = Math.min(BASE_RECONNECT_MS * Math.pow(2, this.reconnectAttempts), MAX_RECONNECT_MS);
         const jitter = delay * JITTER_FACTOR * Math.random();
-        const finalDelay = delay + jitter;
         this.reconnectAttempts++;
         this.reconnectTimer = setTimeout(() => {
             this.connect().catch(() => { });
-        }, finalDelay);
+        }, delay + jitter);
     }
     stopReconnect() {
         if (this.reconnectTimer) {

package/dist/esm/sdk/realtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../../src/sdk/realtime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aerostack/sdk-node",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "author": "Aerostack",
   "type": "module",
   "tshy": {
@@ -36,7 +36,7 @@
     "ws": "^8.19.0"
   },
   "dependencies": {
-    "@aerostack/core": "^0.6.0",
+    "@aerostack/core": "^0.6.7",
     "zod": "^3.25.0 || ^4.0.0"
   },
   "exports": {

package/src/sdk/realtime.ts

@@ -1,48 +1,51 @@
 /**
  * Aerostack Realtime Client for Node.js SDK
- * Provides WebSocket-based real-time data subscription for server-side usage.
- * 
- * This is NOT auto-generated — it is a hand-written extension for the Node SDK.
+ * Production-hardened WebSocket client for server-side usage.
  */
 
-type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+export type RealtimeEvent = 'INSERT' | 'UPDATE' | 'DELETE' | '*';
 
-interface RealtimeMessage {
+export interface RealtimeMessage {
     type: string;
     topic: string;
     [key: string]: any;
 }
 
-interface RealtimeSubscriptionOptions {
+export interface RealtimeSubscriptionOptions {
     event?: RealtimeEvent;
     filter?: Record<string, any>;
 }
 
-type RealtimeCallback = (payload: any) => void;
+export type RealtimeCallback<T = any> = (payload: RealtimePayload<T>) => void;
 
-interface NodeRealtimeOptions {
-    /** Base API URL (e.g. https://api.aerostack.ai/v1) */
+export interface RealtimePayload<T = any> {
+    type: 'db_change' | 'chat_message';
+    topic: string;
+    operation: RealtimeEvent;
+    data: T;
+    old?: T;
+    timestamp?: string;
+    [key: string]: any;
+}
+
+export interface NodeRealtimeOptions {
     serverUrl: string;
-    /** Project ID to subscribe to */
     projectId: string;
-    /** API Key for authentication (recommended for server-side) */
     apiKey?: string | undefined;
-    /** User ID (optional) */
     userId?: string | undefined;
-    /** Bearer token (optional, for user-context connections) */
     token?: string | undefined;
+    maxReconnectAttempts?: number;
 }
 
-// Constants for exponential backoff
 const BASE_RECONNECT_MS = 1000;
 const MAX_RECONNECT_MS = 30000;
 const JITTER_FACTOR = 0.3;
 
-export class RealtimeSubscription {
+export class RealtimeSubscription<T = any> {
     private client: NodeRealtimeClient;
     private topic: string;
     private options: RealtimeSubscriptionOptions;
-    private callbacks: Set<RealtimeCallback> = new Set();
+    private callbacks: Map<RealtimeEvent, Set<RealtimeCallback<T>>> = new Map();
     private _isSubscribed: boolean = false;
 
     constructor(client: NodeRealtimeClient, topic: string, options: RealtimeSubscriptionOptions = {}) {
@@ -51,8 +54,11 @@ export class RealtimeSubscription {
         this.options = options;
     }
 
-    on(_event: RealtimeEvent, callback: RealtimeCallback): this {
-        this.callbacks.add(callback);
+    on(event: RealtimeEvent, callback: RealtimeCallback<T>): this {
+        if (!this.callbacks.has(event)) {
+            this.callbacks.set(event, new Set());
+        }
+        this.callbacks.get(event)!.add(callback);
         return this;
     }
 
@@ -80,51 +86,82 @@ export class RealtimeSubscription {
     get isSubscribed() { return this._isSubscribed; }
 
     /** @internal */
-    _emit(payload: any): void {
+    _emit(payload: RealtimePayload<T>): void {
         const event = payload.operation as RealtimeEvent;
-        const requestedEvent = this.options.event || '*';
-
-        if (requestedEvent === '*' || requestedEvent === event) {
-            for (const cb of this.callbacks) {
-                try {
-                    cb(payload);
-                } catch (e) {
-                    console.error('Realtime callback error:', e);
-                }
-            }
-        }
+        this.callbacks.get(event)?.forEach(cb => {
+            try { cb(payload); } catch (e) { console.error('Realtime callback error:', e); }
+        });
+        this.callbacks.get('*')?.forEach(cb => {
+            try { cb(payload); } catch (e) { console.error('Realtime callback error:', e); }
+        });
     }
 }
 
+export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+
 export class NodeRealtimeClient {
     private wsUrl: string;
     private projectId: string;
     private apiKey: string | undefined;
     private userId: string | undefined;
     private token: string | undefined;
-    private ws: any = null; // WebSocket instance (from 'ws' or global)
+    private ws: any = null;
     private subscriptions: Map<string, RealtimeSubscription> = new Map();
     private reconnectTimer: any = null;
     private heartbeatTimer: any = null;
     private reconnectAttempts: number = 0;
-    private _connected: boolean = false;
+    private _sendQueue: any[] = [];
+    private _connectingPromise: Promise<void> | null = null;
+    private _status: RealtimeStatus = 'idle';
+    private _statusListeners: Set<(s: RealtimeStatus) => void> = new Set();
+    private _lastPong: number = 0;
+    private _maxReconnectAttempts: number;
+    private _maxRetriesListeners: Set<() => void> = new Set();
 
     constructor(options: NodeRealtimeOptions) {
-        // Convert HTTP URL to WS URL
         const base = options.serverUrl.replace(/\/v1\/?$/, '').replace(/^http/, 'ws');
         this.wsUrl = `${base}/api/realtime`;
         this.projectId = options.projectId;
         this.apiKey = options.apiKey;
         this.userId = options.userId;
         this.token = options.token;
+        this._maxReconnectAttempts = options.maxReconnectAttempts ?? Infinity;
+    }
+
+    get status(): RealtimeStatus { return this._status; }
+    get connected(): boolean { return this._status === 'connected'; }
+
+    onStatusChange(cb: (status: RealtimeStatus) => void): () => void {
+        this._statusListeners.add(cb);
+        return () => this._statusListeners.delete(cb);
+    }
+
+    onMaxRetriesExceeded(cb: () => void): () => void {
+        this._maxRetriesListeners.add(cb);
+        return () => this._maxRetriesListeners.delete(cb);
     }
 
-    get connected(): boolean { return this._connected; }
+    private _setStatus(s: RealtimeStatus) {
+        this._status = s;
+        this._statusListeners.forEach(cb => cb(s));
+    }
+
+    setToken(newToken: string): void {
+        this.token = newToken;
+        this._send({ type: 'auth', token: newToken });
+    }
 
     async connect(): Promise<void> {
-        if (this.ws) return;
+        if (this.ws && this._status === 'connected') return;
+        if (this._connectingPromise) return this._connectingPromise;
+        this._connectingPromise = this._doConnect().finally(() => {
+            this._connectingPromise = null;
+        });
+        return this._connectingPromise;
+    }
 
-        // Build URL with query params
+    private async _doConnect(): Promise<void> {
+        this._setStatus('connecting');
         const url = new URL(this.wsUrl);
         if (this.apiKey) {
             url.searchParams.set('apiKey', this.apiKey);
@@ -136,8 +173,6 @@ export class NodeRealtimeClient {
 
         return new Promise(async (resolve, reject) => {
             try {
-                // Try native WebSocket first (Bun, Deno, modern Node 22+)
-                // Fall back to 'ws' package for older Node versions
                 let WsClass: any;
                 if (typeof globalThis.WebSocket !== 'undefined') {
                     WsClass = globalThis.WebSocket;
@@ -146,19 +181,20 @@ export class NodeRealtimeClient {
                         const ws = await import('ws');
                         WsClass = ws.default || ws;
                     } catch {
-                        throw new Error(
-                            'WebSocket not available. Install the "ws" package: npm install ws'
-                        );
+                        throw new Error('WebSocket not available. Install "ws" package.');
                     }
                 }
 
                 this.ws = new WsClass(url.toString());
 
                 this.ws.onopen = () => {
-                    this._connected = true;
-                    this.reconnectAttempts = 0; // Reset backoff on success
+                    this._setStatus('connected');
+                    this.reconnectAttempts = 0;
+                    this._lastPong = Date.now();
                     this.startHeartbeat();
-                    // Re-subscribe existing topics
+                    while (this._sendQueue.length > 0) {
+                        this.ws.send(JSON.stringify(this._sendQueue.shift()));
+                    }
                     for (const sub of this.subscriptions.values()) {
                         if (sub.isSubscribed) sub.subscribe();
                     }
@@ -176,61 +212,80 @@ export class NodeRealtimeClient {
                 };
 
                 this.ws.onclose = () => {
-                    this._connected = false;
+                    this._setStatus('reconnecting');
                     this.stopHeartbeat();
                     this.ws = null;
                     this.scheduleReconnect();
                 };
 
                 this.ws.onerror = (err: any) => {
-                    if (!this._connected) {
-                        reject(err);
-                    }
+                    console.error('Realtime connection error:', err);
+                    this._setStatus('disconnected');
+                    reject(err);
                 };
             } catch (e) {
+                this._setStatus('disconnected');
                 reject(e);
             }
         });
     }
 
     disconnect(): void {
+        this._setStatus('disconnected');
         this.stopReconnect();
         this.stopHeartbeat();
         if (this.ws) {
             this.ws.close();
             this.ws = null;
         }
-        this._connected = false;
+        this._sendQueue = [];
     }
 
-    channel(topic: string, options: RealtimeSubscriptionOptions = {}): RealtimeSubscription {
+    channel<T = any>(topic: string, options: RealtimeSubscriptionOptions = {}): RealtimeSubscription<T> {
         const fullTopic = topic.includes('/') ? topic : `table/${topic}/${this.projectId}`;
-
         let sub = this.subscriptions.get(fullTopic);
         if (!sub) {
-            sub = new RealtimeSubscription(this, fullTopic, options);
+            sub = new RealtimeSubscription<T>(this, fullTopic, options);
             this.subscriptions.set(fullTopic, sub);
         }
-        return sub;
+        return sub as RealtimeSubscription<T>;
+    }
+
+    sendChat(roomId: string, text: string): void {
+        this._send({ type: 'chat', roomId, text });
+    }
+
+    chatRoom(roomId: string): RealtimeSubscription {
+        return this.channel(`chat/${roomId}/${this.projectId}`);
     }
 
     /** @internal */
     _send(data: any): void {
-        if (this.ws && this._connected) {
+        if (this.ws && this._status === 'connected') {
             this.ws.send(JSON.stringify(data));
+        } else {
+            this._sendQueue.push(data);
         }
     }
 
     private handleMessage(data: RealtimeMessage): void {
+        if (data.type === 'pong') {
+            this._lastPong = Date.now();
+            return;
+        }
         if (data.type === 'db_change' || data.type === 'chat_message') {
             const sub = this.subscriptions.get(data.topic);
-            if (sub) sub._emit(data);
+            if (sub) sub._emit(data as any);
         }
     }
 
     private startHeartbeat(): void {
         this.heartbeatTimer = setInterval(() => {
             this._send({ type: 'ping' });
+            if (this._lastPong > 0 && Date.now() - this._lastPong > 70000) {
+                console.warn('Realtime: no pong received, forcing reconnect');
+                this.ws?.close();
+            }
         }, 30000);
     }
 
@@ -241,20 +296,19 @@ export class NodeRealtimeClient {
         }
     }
 
-    /** Exponential backoff with jitter */
     private scheduleReconnect(): void {
         this.stopReconnect();
-        const delay = Math.min(
-            BASE_RECONNECT_MS * Math.pow(2, this.reconnectAttempts),
-            MAX_RECONNECT_MS
-        );
+        if (this.reconnectAttempts >= this._maxReconnectAttempts) {
+            this._setStatus('disconnected');
+            this._maxRetriesListeners.forEach(cb => cb());
+            return;
+        }
+        const delay = Math.min(BASE_RECONNECT_MS * Math.pow(2, this.reconnectAttempts), MAX_RECONNECT_MS);
         const jitter = delay * JITTER_FACTOR * Math.random();
-        const finalDelay = delay + jitter;
-
         this.reconnectAttempts++;
         this.reconnectTimer = setTimeout(() => {
             this.connect().catch(() => { });
-        }, finalDelay);
+        }, delay + jitter);
     }
 
     private stopReconnect(): void {