@synap-core/client 0.1.0 → 0.2.0

package/dist/realtime.d.ts

@@ -1,80 +1,83 @@
 /**
- * Real-time Client - WebSocket connection for live updates
+ * Real-Time Client - WebSocket connection management for Synap
  *
- * Connects to the Synap real-time notification system (Cloudflare Durable Objects)
- * to receive live updates about async operations.
+ * Manages two WebSocket namespaces:
+ * 1. /presence - Generic real-time presence and collaboration
+ * 2. /yjs - Yjs CRDT synchronization
  */
-/**
- * NotificationMessage type definition
- *
- * Matches the type from @synap/realtime but defined here to avoid dependency.
- */
-export interface NotificationMessage {
-    type: string;
-    data: Record<string, unknown>;
-    requestId?: string;
-    timestamp?: string;
-    status?: 'success' | 'error' | 'pending';
-}
+import * as Y from 'yjs';
 export interface RealtimeConfig {
-    /** WebSocket URL (e.g., 'wss://realtime.synap.app/rooms/user_123/subscribe') */
     url: string;
-    /** User ID for the connection */
-    userId: string;
-    /** Callback when a message is received */
-    onMessage?: (message: NotificationMessage) => void;
-    /** Callback when an error occurs */
-    onError?: (error: Error) => void;
-    /** Callback when connection is established */
-    onConnect?: () => void;
-    /** Callback when connection is closed */
-    onDisconnect?: () => void;
-    /** Maximum number of reconnection attempts (default: 5) */
-    maxReconnectAttempts?: number;
-    /** Reconnection delay in milliseconds (default: 1000) */
-    reconnectDelay?: number;
+    auth: {
+        userId: string;
+        userName: string;
+    };
 }
+type EventCallback = (...args: any[]) => void;
 /**
- * Real-time WebSocket Client
+ * Real-time collaboration client
  *
- * Connects to the Synap real-time notification system to receive live updates.
+ * Handles presence tracking and Yjs document synchronization.
  *
  * @example
  * ```typescript
- * const realtime = new SynapRealtimeClient({
- *   url: 'wss://realtime.synap.app/rooms/user_123/subscribe',
- *   userId: 'user-123',
- *   onMessage: (message) => {
- *     console.log('Received:', message);
- *     if (message.type === 'note.creation.completed') {
- *       // Refresh notes list
- *     }
- *   },
+ * const realtime = new RealtimeClient({
+ *   url: 'http://localhost:3001',
+ *   auth: { userId: 'user-123', userName: 'Alice' }
  * });
  *
- * realtime.connect();
+ * // Connect to presence
+ * realtime.connectPresence('view-id', 'whiteboard');
+ * realtime.on('user-joined', (user) => console.log(user));
+ *
+ * // Connect to Yjs
+ * const ydoc = realtime.connectYjs('view-id');
+ * const ymap = ydoc.getMap('shapes');
  * ```
  */
-export declare class SynapRealtimeClient {
-    private ws;
+export declare class RealtimeClient {
     private config;
-    private reconnectAttempts;
-    private maxReconnectAttempts;
-    private reconnectDelay;
-    private reconnectTimer;
-    private isIntentionallyDisconnected;
+    private presenceSocket;
+    private yjsSocket;
+    private listeners;
     constructor(config: RealtimeConfig);
     /**
-     * Connect to the WebSocket server
+     * Connect to presence namespace for real-time collaboration
      */
-    connect(): void;
+    connectPresence(viewId: string, viewType?: string): void;
     /**
-     * Disconnect from the WebSocket server
+     * Connect to Yjs namespace for CRDT synchronization
+     *
+     * @returns Yjs document that auto-syncs with server
      */
-    disconnect(): void;
+    connectYjs(roomName: string): Y.Doc;
+    /**
+     * Subscribe to events
+     */
+    on(event: string, callback: EventCallback): void;
+    /**
+     * Unsubscribe from events
+     */
+    off(event: string, callback: EventCallback): void;
     /**
-     * Check if currently connected
+     * Emit event to all listeners
      */
-    isConnected(): boolean;
-    private attemptReconnect;
+    private emit;
+    /**
+     * Move cursor (presence)
+     */
+    moveCursor(x: number, y: number): void;
+    /**
+     * Set typing indicator
+     */
+    setTyping(isTyping: boolean): void;
+    /**
+     * Disconnect all connections
+     */
+    disconnect(): void;
 }
+/**
+ * Create a real-time client instance
+ */
+export declare function createRealtimeClient(config: RealtimeConfig): RealtimeClient;
+export {};

package/dist/realtime.js

@@ -1,92 +1,8 @@
-// src/realtime.ts
-var SynapRealtimeClient = class {
-  ws = null;
-  config;
-  reconnectAttempts = 0;
-  maxReconnectAttempts;
-  reconnectDelay;
-  reconnectTimer = null;
-  isIntentionallyDisconnected = false;
-  constructor(config) {
-    this.config = config;
-    this.maxReconnectAttempts = config.maxReconnectAttempts ?? 5;
-    this.reconnectDelay = config.reconnectDelay ?? 1e3;
-  }
-  /**
-   * Connect to the WebSocket server
-   */
-  connect() {
-    if (this.ws?.readyState === WebSocket.OPEN) {
-      return;
-    }
-    this.isIntentionallyDisconnected = false;
-    const wsUrl = this.config.url;
-    try {
-      this.ws = new WebSocket(wsUrl);
-      this.ws.onopen = () => {
-        this.reconnectAttempts = 0;
-        this.config.onConnect?.();
-      };
-      this.ws.onmessage = (event) => {
-        try {
-          const message = JSON.parse(event.data);
-          this.config.onMessage?.(message);
-        } catch (error) {
-          console.error("Failed to parse WebSocket message:", error);
-          this.config.onError?.(
-            new Error(`Failed to parse message: ${error instanceof Error ? error.message : String(error)}`)
-          );
-        }
-      };
-      this.ws.onerror = () => {
-        this.config.onError?.(new Error("WebSocket error"));
-      };
-      this.ws.onclose = () => {
-        this.config.onDisconnect?.();
-        if (!this.isIntentionallyDisconnected) {
-          this.attemptReconnect();
-        }
-      };
-    } catch (error) {
-      this.config.onError?.(
-        error instanceof Error ? error : new Error(String(error))
-      );
-    }
-  }
-  /**
-   * Disconnect from the WebSocket server
-   */
-  disconnect() {
-    this.isIntentionallyDisconnected = true;
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = null;
-    }
-    if (this.ws) {
-      this.ws.close();
-      this.ws = null;
-    }
-  }
-  /**
-   * Check if currently connected
-   */
-  isConnected() {
-    return this.ws?.readyState === WebSocket.OPEN;
-  }
-  attemptReconnect() {
-    if (this.reconnectAttempts >= this.maxReconnectAttempts) {
-      this.config.onError?.(
-        new Error(`Max reconnection attempts (${this.maxReconnectAttempts}) reached`)
-      );
-      return;
-    }
-    this.reconnectAttempts++;
-    const delay = this.reconnectDelay * this.reconnectAttempts;
-    this.reconnectTimer = setTimeout(() => {
-      this.connect();
-    }, delay);
-  }
-};
+import {
+  RealtimeClient,
+  createRealtimeClient
+} from "./chunk-BVKLN5W3.js";
 export {
-  SynapRealtimeClient
+  RealtimeClient,
+  createRealtimeClient
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synap-core/client",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Type-safe client SDK for Synap Core OS",
   "type": "module",
   "publishConfig": {
@@ -32,9 +32,13 @@
   ],
   "dependencies": {
     "@trpc/client": "^11.0.0",
-    "zod": "^3.22.0"
+    "zod": "^3.22.0",
+    "socket.io-client": "^4.7.2",
+    "yjs": "^13.6.11",
+    "lib0": "^0.2.97"
   },
   "peerDependencies": {
+    "@synap-core/types": "^0.1.0",
     "@tanstack/react-query": "^5.0.0",
     "@trpc/react-query": "^11.0.0",
     "react": "^18.0.0"
@@ -58,7 +62,10 @@
     "client",
     "sdk",
     "knowledge-management",
-    "ai"
+    "ai",
+    "realtime",
+    "websocket",
+    "yjs"
   ],
   "license": "MIT",
   "repository": {