@blinkdotnew/dev-sdk 2.3.2 → 2.3.4-dev.1

package/dist/index.d.mts

@@ -946,6 +946,10 @@ declare class HttpClient {
     dbPost<T = any>(table: string, body: any, options?: {
         returning?: boolean;
     }): Promise<BlinkResponse<T | T[]>>;
+    dbUpsert<T = any>(table: string, body: any, options?: {
+        onConflict?: string;
+        returning?: boolean;
+    }): Promise<BlinkResponse<T | T[]>>;
     dbPatch<T = any>(table: string, body: any, searchParams?: Record<string, string>, options?: {
         returning?: boolean;
     }): Promise<BlinkResponse<T[]>>;
@@ -3488,27 +3492,93 @@ declare class BlinkAIImpl implements BlinkAI {
 }
 
 /**
- * Blink Realtime Module - Real-time messaging and presence
- * Provides pub/sub messaging, presence tracking, and live updates
+ * Blink Realtime Connection - Single WebSocket connection manager
+ * Handles connection lifecycle, message routing, and reconnection for all channels
  */
 
-declare class BlinkRealtimeChannel implements RealtimeChannel {
-    private channelName;
+interface ChannelHandler {
+    onMessage: (message: any) => void;
+    onPresence: (users: any[]) => void;
+    onSubscribed: () => void;
+    onError: (error: string) => void;
+}
+declare class RealtimeConnection {
     private httpClient;
     private projectId;
-    private messageCallbacks;
-    private presenceCallbacks;
     private websocket;
-    private isSubscribed;
     private isConnected;
     private isConnecting;
     private reconnectTimer;
     private heartbeatTimer;
     private reconnectAttempts;
-    private messageQueue;
-    private pendingSubscription;
     private connectionPromise;
-    constructor(channelName: string, httpClient: HttpClient, projectId: string);
+    private channels;
+    private pendingSubscriptions;
+    private messageQueue;
+    constructor(httpClient: HttpClient, projectId: string);
+    /**
+     * Check if connection is ready
+     */
+    isReady(): boolean;
+    /**
+     * Ensure WebSocket connection is established
+     */
+    connect(): Promise<void>;
+    /**
+     * Join a channel (subscribe)
+     */
+    joinChannel(channelName: string, handler: ChannelHandler, options?: {
+        userId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * Leave a channel (unsubscribe)
+     */
+    leaveChannel(channelName: string): Promise<void>;
+    /**
+     * Send a message to a channel
+     */
+    send(channelName: string, type: string, data: any, options?: {
+        userId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<string>;
+    /**
+     * Disconnect and cleanup
+     */
+    disconnect(): void;
+    /**
+     * Get count of active channels
+     */
+    getChannelCount(): number;
+    private connectWebSocket;
+    private handleMessage;
+    private sendRaw;
+    private sendWithResponse;
+    private flushMessageQueue;
+    private rejectQueuedMessages;
+    private startHeartbeat;
+    private scheduleReconnect;
+    private resubscribeAllChannels;
+}
+
+/**
+ * Blink Realtime Module - Real-time messaging and presence
+ * Provides pub/sub messaging, presence tracking, and live updates
+ *
+ * Architecture: Single WebSocket connection per client, multiplexed channels
+ * (Industry standard - matches Supabase, Firebase, Pusher)
+ */
+
+declare class BlinkRealtimeChannel implements RealtimeChannel {
+    private channelName;
+    private connection;
+    private httpClient;
+    private projectId;
+    private messageCallbacks;
+    private presenceCallbacks;
+    private isSubscribed;
+    private subscribeOptions;
+    constructor(channelName: string, connection: RealtimeConnection, httpClient: HttpClient, projectId: string);
     /**
      * Check if channel is ready for publishing
      */
@@ -3530,35 +3600,12 @@ declare class BlinkRealtimeChannel implements RealtimeChannel {
         before?: string;
         after?: string;
     }): Promise<RealtimeMessage[]>;
-    /**
-     * Ensure WebSocket connection is established and ready
-     */
-    private ensureConnected;
-    /**
-     * Send a message, queuing if socket not ready
-     */
-    private sendMessage;
-    /**
-     * Send a queued message and set up response handling
-     */
-    private sendQueuedMessage;
-    /**
-     * Flush all queued messages when connection becomes ready
-     */
-    private flushMessageQueue;
-    private connectWebSocket;
-    /**
-     * Reject all queued messages with the given error
-     */
-    private rejectQueuedMessages;
-    private handleWebSocketMessage;
-    private startHeartbeat;
-    private scheduleReconnect;
     private cleanup;
 }
 declare class BlinkRealtimeImpl implements BlinkRealtime {
     private httpClient;
     private projectId;
+    private connection;
     private channels;
     private handlers;
     constructor(httpClient: HttpClient, projectId: string);
@@ -3567,6 +3614,14 @@ declare class BlinkRealtimeImpl implements BlinkRealtime {
     publish(channelName: string, type: string, data: any, options?: RealtimePublishOptions): Promise<string>;
     presence(channelName: string): Promise<PresenceUser[]>;
     onPresence(channelName: string, callback: (users: PresenceUser[]) => void): () => void;
+    /**
+     * Get the number of active WebSocket connections (should always be 0 or 1)
+     */
+    getConnectionCount(): number;
+    /**
+     * Get the number of active channels
+     */
+    getChannelCount(): number;
 }
 
 declare class BlinkConnectorsImpl implements BlinkConnectors {

package/dist/index.d.ts

@@ -946,6 +946,10 @@ declare class HttpClient {
     dbPost<T = any>(table: string, body: any, options?: {
         returning?: boolean;
     }): Promise<BlinkResponse<T | T[]>>;
+    dbUpsert<T = any>(table: string, body: any, options?: {
+        onConflict?: string;
+        returning?: boolean;
+    }): Promise<BlinkResponse<T | T[]>>;
     dbPatch<T = any>(table: string, body: any, searchParams?: Record<string, string>, options?: {
         returning?: boolean;
     }): Promise<BlinkResponse<T[]>>;
@@ -3488,27 +3492,93 @@ declare class BlinkAIImpl implements BlinkAI {
 }
 
 /**
- * Blink Realtime Module - Real-time messaging and presence
- * Provides pub/sub messaging, presence tracking, and live updates
+ * Blink Realtime Connection - Single WebSocket connection manager
+ * Handles connection lifecycle, message routing, and reconnection for all channels
  */
 
-declare class BlinkRealtimeChannel implements RealtimeChannel {
-    private channelName;
+interface ChannelHandler {
+    onMessage: (message: any) => void;
+    onPresence: (users: any[]) => void;
+    onSubscribed: () => void;
+    onError: (error: string) => void;
+}
+declare class RealtimeConnection {
     private httpClient;
     private projectId;
-    private messageCallbacks;
-    private presenceCallbacks;
     private websocket;
-    private isSubscribed;
     private isConnected;
     private isConnecting;
     private reconnectTimer;
     private heartbeatTimer;
     private reconnectAttempts;
-    private messageQueue;
-    private pendingSubscription;
     private connectionPromise;
-    constructor(channelName: string, httpClient: HttpClient, projectId: string);
+    private channels;
+    private pendingSubscriptions;
+    private messageQueue;
+    constructor(httpClient: HttpClient, projectId: string);
+    /**
+     * Check if connection is ready
+     */
+    isReady(): boolean;
+    /**
+     * Ensure WebSocket connection is established
+     */
+    connect(): Promise<void>;
+    /**
+     * Join a channel (subscribe)
+     */
+    joinChannel(channelName: string, handler: ChannelHandler, options?: {
+        userId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    /**
+     * Leave a channel (unsubscribe)
+     */
+    leaveChannel(channelName: string): Promise<void>;
+    /**
+     * Send a message to a channel
+     */
+    send(channelName: string, type: string, data: any, options?: {
+        userId?: string;
+        metadata?: Record<string, any>;
+    }): Promise<string>;
+    /**
+     * Disconnect and cleanup
+     */
+    disconnect(): void;
+    /**
+     * Get count of active channels
+     */
+    getChannelCount(): number;
+    private connectWebSocket;
+    private handleMessage;
+    private sendRaw;
+    private sendWithResponse;
+    private flushMessageQueue;
+    private rejectQueuedMessages;
+    private startHeartbeat;
+    private scheduleReconnect;
+    private resubscribeAllChannels;
+}
+
+/**
+ * Blink Realtime Module - Real-time messaging and presence
+ * Provides pub/sub messaging, presence tracking, and live updates
+ *
+ * Architecture: Single WebSocket connection per client, multiplexed channels
+ * (Industry standard - matches Supabase, Firebase, Pusher)
+ */
+
+declare class BlinkRealtimeChannel implements RealtimeChannel {
+    private channelName;
+    private connection;
+    private httpClient;
+    private projectId;
+    private messageCallbacks;
+    private presenceCallbacks;
+    private isSubscribed;
+    private subscribeOptions;
+    constructor(channelName: string, connection: RealtimeConnection, httpClient: HttpClient, projectId: string);
     /**
      * Check if channel is ready for publishing
      */
@@ -3530,35 +3600,12 @@ declare class BlinkRealtimeChannel implements RealtimeChannel {
         before?: string;
         after?: string;
     }): Promise<RealtimeMessage[]>;
-    /**
-     * Ensure WebSocket connection is established and ready
-     */
-    private ensureConnected;
-    /**
-     * Send a message, queuing if socket not ready
-     */
-    private sendMessage;
-    /**
-     * Send a queued message and set up response handling
-     */
-    private sendQueuedMessage;
-    /**
-     * Flush all queued messages when connection becomes ready
-     */
-    private flushMessageQueue;
-    private connectWebSocket;
-    /**
-     * Reject all queued messages with the given error
-     */
-    private rejectQueuedMessages;
-    private handleWebSocketMessage;
-    private startHeartbeat;
-    private scheduleReconnect;
     private cleanup;
 }
 declare class BlinkRealtimeImpl implements BlinkRealtime {
     private httpClient;
     private projectId;
+    private connection;
     private channels;
     private handlers;
     constructor(httpClient: HttpClient, projectId: string);
@@ -3567,6 +3614,14 @@ declare class BlinkRealtimeImpl implements BlinkRealtime {
     publish(channelName: string, type: string, data: any, options?: RealtimePublishOptions): Promise<string>;
     presence(channelName: string): Promise<PresenceUser[]>;
     onPresence(channelName: string, callback: (users: PresenceUser[]) => void): () => void;
+    /**
+     * Get the number of active WebSocket connections (should always be 0 or 1)
+     */
+    getConnectionCount(): number;
+    /**
+     * Get the number of active channels
+     */
+    getChannelCount(): number;
 }
 
 declare class BlinkConnectorsImpl implements BlinkConnectors {