@voidhash/mimic 0.0.2 → 0.0.4

package/dist/client/WebSocketTransport.mjs

@@ -0,0 +1,392 @@
+import { __export } from "../_virtual/rolldown_runtime.mjs";
+import { decode, encode } from "../Transaction.mjs";
+import { AuthenticationError, WebSocketError } from "./errors.mjs";
+
+//#region src/client/WebSocketTransport.ts
+var WebSocketTransport_exports = /* @__PURE__ */ __export({ make: () => make });
+/**
+* Creates a WebSocket-based transport for real-time server communication.
+*/
+/**
+* Build the WebSocket URL with optional document ID path.
+*/
+const buildWebSocketUrl = (baseUrl, documentId) => {
+	if (!documentId) return baseUrl;
+	return `${baseUrl.replace(/\/+$/, "")}/doc/${encodeURIComponent(documentId)}`;
+};
+const make = (options) => {
+	const { url: baseUrl, documentId, protocols, authToken, onEvent, connectionTimeout = 1e4, autoReconnect = true, maxReconnectAttempts = 10, reconnectDelay = 1e3, maxReconnectDelay = 3e4, heartbeatInterval = 3e4, heartbeatTimeout = 1e4 } = options;
+	const url = buildWebSocketUrl(baseUrl, documentId);
+	let _state = { type: "disconnected" };
+	let _ws = null;
+	let _messageHandlers = /* @__PURE__ */ new Set();
+	let _connectionTimeoutHandle = null;
+	let _heartbeatIntervalHandle = null;
+	let _heartbeatTimeoutHandle = null;
+	let _reconnectTimeoutHandle = null;
+	let _messageQueue = [];
+	let _connectResolver = null;
+	let _connectRejecter = null;
+	let _reconnectAttempt = 0;
+	const emit = (handler, event) => {
+		handler === null || handler === void 0 || handler(event);
+	};
+	/**
+	* Encodes a client message for network transport.
+	*/
+	const encodeClientMessage = (message) => {
+		if (message.type === "submit") return {
+			type: "submit",
+			transaction: encode(message.transaction)
+		};
+		return message;
+	};
+	/**
+	* Decodes a server message from network transport.
+	*/
+	const decodeServerMessage = (encoded) => {
+		if (encoded.type === "transaction") return {
+			type: "transaction",
+			transaction: decode(encoded.transaction),
+			version: encoded.version
+		};
+		return encoded;
+	};
+	/**
+	* Sends a raw message over the WebSocket.
+	*/
+	const sendRaw = (message) => {
+		if (_ws && _ws.readyState === WebSocket.OPEN) _ws.send(JSON.stringify(encodeClientMessage(message)));
+	};
+	/**
+	* Clears all active timers.
+	*/
+	const clearTimers = () => {
+		if (_connectionTimeoutHandle) {
+			clearTimeout(_connectionTimeoutHandle);
+			_connectionTimeoutHandle = null;
+		}
+		if (_heartbeatIntervalHandle) {
+			clearInterval(_heartbeatIntervalHandle);
+			_heartbeatIntervalHandle = null;
+		}
+		if (_heartbeatTimeoutHandle) {
+			clearTimeout(_heartbeatTimeoutHandle);
+			_heartbeatTimeoutHandle = null;
+		}
+		if (_reconnectTimeoutHandle) {
+			clearTimeout(_reconnectTimeoutHandle);
+			_reconnectTimeoutHandle = null;
+		}
+	};
+	/**
+	* Starts the heartbeat mechanism.
+	*/
+	const startHeartbeat = () => {
+		stopHeartbeat();
+		_heartbeatIntervalHandle = setInterval(() => {
+			if (_state.type !== "connected") return;
+			sendRaw({ type: "ping" });
+			_heartbeatTimeoutHandle = setTimeout(() => {
+				handleConnectionLost("Heartbeat timeout");
+			}, heartbeatTimeout);
+		}, heartbeatInterval);
+	};
+	/**
+	* Stops the heartbeat mechanism.
+	*/
+	const stopHeartbeat = () => {
+		if (_heartbeatIntervalHandle) {
+			clearInterval(_heartbeatIntervalHandle);
+			_heartbeatIntervalHandle = null;
+		}
+		if (_heartbeatTimeoutHandle) {
+			clearTimeout(_heartbeatTimeoutHandle);
+			_heartbeatTimeoutHandle = null;
+		}
+	};
+	/**
+	* Handles pong response - clears the heartbeat timeout.
+	*/
+	const handlePong = () => {
+		if (_heartbeatTimeoutHandle) {
+			clearTimeout(_heartbeatTimeoutHandle);
+			_heartbeatTimeoutHandle = null;
+		}
+	};
+	/**
+	* Flushes the message queue after reconnection.
+	*/
+	const flushMessageQueue = () => {
+		const queue = _messageQueue;
+		_messageQueue = [];
+		for (const message of queue) sendRaw(message);
+	};
+	/**
+	* Calculates reconnection delay with exponential backoff.
+	*/
+	const getReconnectDelay = (attempt) => {
+		const delay = reconnectDelay * Math.pow(2, attempt);
+		return Math.min(delay, maxReconnectDelay);
+	};
+	/**
+	* Resolves the auth token (handles both string and function).
+	* Returns empty string if no token is configured.
+	*/
+	const resolveAuthToken = async () => {
+		if (!authToken) return "";
+		if (typeof authToken === "string") return authToken;
+		return authToken();
+	};
+	/**
+	* Performs authentication after connection.
+	* Always sends an auth message (even with empty token) to trigger server auth flow.
+	*/
+	const authenticate = async () => {
+		const token = await resolveAuthToken();
+		_state = { type: "authenticating" };
+		sendRaw({
+			type: "auth",
+			token
+		});
+	};
+	/**
+	* Handles authentication result from server.
+	*/
+	const handleAuthResult = (success, error) => {
+		if (!success) {
+			const authError = new AuthenticationError(error || "Authentication failed");
+			cleanup();
+			_connectRejecter === null || _connectRejecter === void 0 || _connectRejecter(authError);
+			_connectResolver = null;
+			_connectRejecter = null;
+			emit(onEvent, {
+				type: "error",
+				error: authError
+			});
+			return;
+		}
+		completeConnection();
+	};
+	/**
+	* Completes the connection process.
+	*/
+	const completeConnection = () => {
+		_state = { type: "connected" };
+		_reconnectAttempt = 0;
+		if (_connectionTimeoutHandle) {
+			clearTimeout(_connectionTimeoutHandle);
+			_connectionTimeoutHandle = null;
+		}
+		startHeartbeat();
+		flushMessageQueue();
+		_connectResolver === null || _connectResolver === void 0 || _connectResolver();
+		_connectResolver = null;
+		_connectRejecter = null;
+		emit(onEvent, { type: "connected" });
+	};
+	/**
+	* Cleans up WebSocket and related state.
+	*/
+	const cleanup = () => {
+		clearTimers();
+		if (_ws) {
+			_ws.onopen = null;
+			_ws.onclose = null;
+			_ws.onerror = null;
+			_ws.onmessage = null;
+			if (_ws.readyState === WebSocket.OPEN || _ws.readyState === WebSocket.CONNECTING) _ws.close();
+			_ws = null;
+		}
+	};
+	/**
+	* Handles connection lost - initiates reconnection if enabled.
+	*/
+	const handleConnectionLost = (reason) => {
+		cleanup();
+		if (_state.type === "disconnected") return;
+		if (_connectRejecter !== null) {
+			_state = { type: "disconnected" };
+			_reconnectAttempt = 0;
+			_connectRejecter(new WebSocketError("Connection failed", void 0, reason));
+			_connectResolver = null;
+			_connectRejecter = null;
+			emit(onEvent, {
+				type: "disconnected",
+				reason
+			});
+			return;
+		}
+		if (!autoReconnect) {
+			_state = { type: "disconnected" };
+			_reconnectAttempt = 0;
+			emit(onEvent, {
+				type: "disconnected",
+				reason
+			});
+			return;
+		}
+		_reconnectAttempt++;
+		if (_reconnectAttempt > maxReconnectAttempts) {
+			_state = { type: "disconnected" };
+			_reconnectAttempt = 0;
+			emit(onEvent, {
+				type: "disconnected",
+				reason: "Max reconnection attempts reached"
+			});
+			return;
+		}
+		_state = {
+			type: "reconnecting",
+			attempt: _reconnectAttempt
+		};
+		emit(onEvent, {
+			type: "reconnecting",
+			attempt: _reconnectAttempt
+		});
+		const delay = getReconnectDelay(_reconnectAttempt - 1);
+		_reconnectTimeoutHandle = setTimeout(() => {
+			_reconnectTimeoutHandle = null;
+			attemptConnection();
+		}, delay);
+	};
+	/**
+	* Attempts to establish WebSocket connection.
+	*/
+	const attemptConnection = () => {
+		if (_state.type === "connected") return;
+		_state = { type: "connecting" };
+		try {
+			_ws = new WebSocket(url, protocols);
+		} catch (error) {
+			handleConnectionLost(error.message);
+			return;
+		}
+		_connectionTimeoutHandle = setTimeout(() => {
+			_connectionTimeoutHandle = null;
+			handleConnectionLost("Connection timeout");
+		}, connectionTimeout);
+		_ws.onopen = async () => {
+			if (_connectionTimeoutHandle) {
+				clearTimeout(_connectionTimeoutHandle);
+				_connectionTimeoutHandle = null;
+			}
+			try {
+				await authenticate();
+			} catch (error) {
+				handleConnectionLost(error.message);
+			}
+		};
+		_ws.onclose = (event) => {
+			handleConnectionLost(event.reason || `Connection closed (code: ${event.code})`);
+		};
+		_ws.onerror = () => {};
+		_ws.onmessage = (event) => {
+			try {
+				handleMessage(decodeServerMessage(JSON.parse(event.data)));
+			} catch (_unused) {}
+		};
+	};
+	/**
+	* Handles incoming server messages.
+	*/
+	const handleMessage = (message) => {
+		if (message.type === "pong") {
+			handlePong();
+			return;
+		}
+		if (message.type === "auth_result") {
+			handleAuthResult(message.success, message.error);
+			return;
+		}
+		for (const handler of _messageHandlers) try {
+			handler(message);
+		} catch (_unused2) {}
+	};
+	return {
+		send: (transaction) => {
+			const message = {
+				type: "submit",
+				transaction
+			};
+			if (_state.type === "connected") sendRaw(message);
+			else if (_state.type === "reconnecting") _messageQueue.push(message);
+		},
+		requestSnapshot: () => {
+			const message = { type: "request_snapshot" };
+			if (_state.type === "connected") sendRaw(message);
+			else if (_state.type === "reconnecting") _messageQueue.push(message);
+		},
+		subscribe: (handler) => {
+			_messageHandlers.add(handler);
+			return () => {
+				_messageHandlers.delete(handler);
+			};
+		},
+		connect: async () => {
+			if (_state.type === "connected") return;
+			if (_state.type === "connecting" || _state.type === "authenticating") return new Promise((resolve, reject) => {
+				const existingResolver = _connectResolver;
+				const existingRejecter = _connectRejecter;
+				_connectResolver = () => {
+					existingResolver === null || existingResolver === void 0 || existingResolver();
+					resolve();
+				};
+				_connectRejecter = (error) => {
+					existingRejecter === null || existingRejecter === void 0 || existingRejecter(error);
+					reject(error);
+				};
+			});
+			return new Promise((resolve, reject) => {
+				_connectResolver = resolve;
+				_connectRejecter = reject;
+				attemptConnection();
+			});
+		},
+		disconnect: () => {
+			if (_reconnectTimeoutHandle) {
+				clearTimeout(_reconnectTimeoutHandle);
+				_reconnectTimeoutHandle = null;
+			}
+			if (_connectRejecter) {
+				_connectRejecter(new WebSocketError("Disconnected by user"));
+				_connectResolver = null;
+				_connectRejecter = null;
+			}
+			cleanup();
+			_state = { type: "disconnected" };
+			_reconnectAttempt = 0;
+			_messageQueue = [];
+			emit(onEvent, {
+				type: "disconnected",
+				reason: "User disconnected"
+			});
+		},
+		isConnected: () => {
+			return _state.type === "connected";
+		},
+		sendPresenceSet: (data) => {
+			const message = {
+				type: "presence_set",
+				data
+			};
+			if (_state.type === "connected") sendRaw(message);
+			else if (_state.type === "reconnecting") {
+				_messageQueue = _messageQueue.filter((message$1) => message$1.type !== "presence_set");
+				_messageQueue.push(message);
+			}
+		},
+		sendPresenceClear: () => {
+			const message = { type: "presence_clear" };
+			if (_state.type === "connected") sendRaw(message);
+			else if (_state.type === "reconnecting") {
+				_messageQueue = _messageQueue.filter((message$1) => message$1.type !== "presence_clear");
+				_messageQueue.push(message);
+			}
+		}
+	};
+};
+
+//#endregion
+export { WebSocketTransport_exports };
+//# sourceMappingURL=WebSocketTransport.mjs.map

package/dist/client/WebSocketTransport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketTransport.mjs","names":["_state: ConnectionState","_ws: WebSocket | null","_messageHandlers: Set<(message: Transport.ServerMessage) => void>","_connectionTimeoutHandle: ReturnType<typeof setTimeout> | null","_heartbeatIntervalHandle: ReturnType<typeof setInterval> | null","_heartbeatTimeoutHandle: ReturnType<typeof setTimeout> | null","_reconnectTimeoutHandle: ReturnType<typeof setTimeout> | null","_messageQueue: Transport.ClientMessage[]","_connectResolver: (() => void) | null","_connectRejecter: ((error: Error) => void) | null","Transaction.encode","Transaction.decode","message: Transport.ClientMessage","message"],"sources":["../../src/client/WebSocketTransport.ts"],"sourcesContent":["import * as Transaction from \"../Transaction\";\n\nimport * as Transport from \"./Transport\";\nimport { WebSocketError, AuthenticationError } from \"./errors\";\n\n// =============================================================================\n// WebSocket Transport Options\n// =============================================================================\n\n/**\n * Options for creating a WebSocket transport.\n */\nexport interface WebSocketTransportOptions extends Transport.TransportOptions {\n  /** WebSocket URL (ws:// or wss://) - base URL without document path */\n  readonly url: string;\n  /** Document ID to connect to. Will be appended to URL as /doc/{documentId} */\n  readonly documentId?: string;\n  /** WebSocket subprotocols */\n  readonly protocols?: string[];\n  /** Authentication token or function that returns a token */\n  readonly authToken?: string | (() => string | Promise<string>);\n  /** Interval between heartbeat pings (ms). Default: 30000 */\n  readonly heartbeatInterval?: number;\n  /** Timeout to wait for pong response (ms). Default: 10000 */\n  readonly heartbeatTimeout?: number;\n  /** Maximum delay between reconnection attempts (ms). Default: 30000 */\n  readonly maxReconnectDelay?: number;\n}\n\n// =============================================================================\n// Connection State\n// =============================================================================\n\ntype ConnectionState =\n  | { type: \"disconnected\" }\n  | { type: \"connecting\" }\n  | { type: \"authenticating\" }\n  | { type: \"connected\" }\n  | { type: \"reconnecting\"; attempt: number };\n\n// =============================================================================\n// WebSocket Transport Implementation\n// =============================================================================\n\n/**\n * Creates a WebSocket-based transport for real-time server communication.\n */\n/**\n * Build the WebSocket URL with optional document ID path.\n */\nconst buildWebSocketUrl = (baseUrl: string, documentId?: string): string => {\n  if (!documentId) {\n    return baseUrl;\n  }\n  // Remove trailing slash from base URL\n  const normalizedBase = baseUrl.replace(/\\/+$/, \"\");\n  // Encode the document ID for URL safety\n  const encodedDocId = encodeURIComponent(documentId);\n  return `${normalizedBase}/doc/${encodedDocId}`;\n};\n\nexport const make = (options: WebSocketTransportOptions): Transport.Transport => {\n  const {\n    url: baseUrl,\n    documentId,\n    protocols,\n    authToken,\n    onEvent,\n    connectionTimeout = 10000,\n    autoReconnect = true,\n    maxReconnectAttempts = 10,\n    reconnectDelay = 1000,\n    maxReconnectDelay = 30000,\n    heartbeatInterval = 30000,\n    heartbeatTimeout = 10000,\n  } = options;\n\n  // Build the full URL with document ID if provided\n  const url = buildWebSocketUrl(baseUrl, documentId);\n\n  // ==========================================================================\n  // Internal State\n  // ==========================================================================\n\n  let _state: ConnectionState = { type: \"disconnected\" };\n  let _ws: WebSocket | null = null;\n  let _messageHandlers: Set<(message: Transport.ServerMessage) => void> = new Set();\n\n  // Timers\n  let _connectionTimeoutHandle: ReturnType<typeof setTimeout> | null = null;\n  let _heartbeatIntervalHandle: ReturnType<typeof setInterval> | null = null;\n  let _heartbeatTimeoutHandle: ReturnType<typeof setTimeout> | null = null;\n  let _reconnectTimeoutHandle: ReturnType<typeof setTimeout> | null = null;\n\n  // Message queue for messages sent while reconnecting\n  let _messageQueue: Transport.ClientMessage[] = [];\n\n  // Promise resolvers for connect()\n  let _connectResolver: (() => void) | null = null;\n  let _connectRejecter: ((error: Error) => void) | null = null;\n\n  // Track reconnection attempt count (persists through connecting state)\n  let _reconnectAttempt = 0;\n\n  // ==========================================================================\n  // Helper Functions\n  // ==========================================================================\n\n  const emit = (handler: Transport.TransportEventHandler | undefined, event: Parameters<Transport.TransportEventHandler>[0]) => {\n    handler?.(event);\n  };\n\n  /**\n   * Encodes a client message for network transport.\n   */\n  const encodeClientMessage = (message: Transport.ClientMessage): Transport.EncodedClientMessage => {\n    if (message.type === \"submit\") {\n      return {\n        type: \"submit\",\n        transaction: Transaction.encode(message.transaction),\n      };\n    }\n    return message;\n  };\n\n  /**\n   * Decodes a server message from network transport.\n   */\n  const decodeServerMessage = (encoded: Transport.EncodedServerMessage): Transport.ServerMessage => {\n    if (encoded.type === \"transaction\") {\n      return {\n        type: \"transaction\",\n        transaction: Transaction.decode(encoded.transaction),\n        version: encoded.version,\n      };\n    }\n    return encoded;\n  };\n\n  /**\n   * Sends a raw message over the WebSocket.\n   */\n  const sendRaw = (message: Transport.ClientMessage): void => {\n    if (_ws && _ws.readyState === WebSocket.OPEN) {\n      _ws.send(JSON.stringify(encodeClientMessage(message)));\n    }\n  };\n\n  /**\n   * Clears all active timers.\n   */\n  const clearTimers = (): void => {\n    if (_connectionTimeoutHandle) {\n      clearTimeout(_connectionTimeoutHandle);\n      _connectionTimeoutHandle = null;\n    }\n    if (_heartbeatIntervalHandle) {\n      clearInterval(_heartbeatIntervalHandle);\n      _heartbeatIntervalHandle = null;\n    }\n    if (_heartbeatTimeoutHandle) {\n      clearTimeout(_heartbeatTimeoutHandle);\n      _heartbeatTimeoutHandle = null;\n    }\n    if (_reconnectTimeoutHandle) {\n      clearTimeout(_reconnectTimeoutHandle);\n      _reconnectTimeoutHandle = null;\n    }\n  };\n\n  /**\n   * Starts the heartbeat mechanism.\n   */\n  const startHeartbeat = (): void => {\n    stopHeartbeat();\n\n    _heartbeatIntervalHandle = setInterval(() => {\n      if (_state.type !== \"connected\") return;\n\n      // Send ping\n      sendRaw({ type: \"ping\" });\n\n      // Set timeout for pong response\n      _heartbeatTimeoutHandle = setTimeout(() => {\n        // No pong received - connection is dead\n        handleConnectionLost(\"Heartbeat timeout\");\n      }, heartbeatTimeout);\n    }, heartbeatInterval);\n  };\n\n  /**\n   * Stops the heartbeat mechanism.\n   */\n  const stopHeartbeat = (): void => {\n    if (_heartbeatIntervalHandle) {\n      clearInterval(_heartbeatIntervalHandle);\n      _heartbeatIntervalHandle = null;\n    }\n    if (_heartbeatTimeoutHandle) {\n      clearTimeout(_heartbeatTimeoutHandle);\n      _heartbeatTimeoutHandle = null;\n    }\n  };\n\n  /**\n   * Handles pong response - clears the heartbeat timeout.\n   */\n  const handlePong = (): void => {\n    if (_heartbeatTimeoutHandle) {\n      clearTimeout(_heartbeatTimeoutHandle);\n      _heartbeatTimeoutHandle = null;\n    }\n  };\n\n  /**\n   * Flushes the message queue after reconnection.\n   */\n  const flushMessageQueue = (): void => {\n    const queue = _messageQueue;\n    _messageQueue = [];\n    for (const message of queue) {\n      sendRaw(message);\n    }\n  };\n\n  /**\n   * Calculates reconnection delay with exponential backoff.\n   */\n  const getReconnectDelay = (attempt: number): number => {\n    const delay = reconnectDelay * Math.pow(2, attempt);\n    return Math.min(delay, maxReconnectDelay);\n  };\n\n  /**\n   * Resolves the auth token (handles both string and function).\n   * Returns empty string if no token is configured.\n   */\n  const resolveAuthToken = async (): Promise<string> => {\n    if (!authToken) return \"\";\n    if (typeof authToken === \"string\") return authToken;\n    return authToken();\n  };\n\n  /**\n   * Performs authentication after connection.\n   * Always sends an auth message (even with empty token) to trigger server auth flow.\n   */\n  const authenticate = async (): Promise<void> => {\n    const token = await resolveAuthToken();\n    _state = { type: \"authenticating\" };\n    sendRaw({ type: \"auth\", token });\n  };\n\n  /**\n   * Handles authentication result from server.\n   */\n  const handleAuthResult = (success: boolean, error?: string): void => {\n    if (!success) {\n      const authError = new AuthenticationError(error || \"Authentication failed\");\n      cleanup();\n      _connectRejecter?.(authError);\n      _connectResolver = null;\n      _connectRejecter = null;\n      emit(onEvent, { type: \"error\", error: authError });\n      return;\n    }\n\n    // Auth successful - complete connection\n    completeConnection();\n  };\n\n  /**\n   * Completes the connection process.\n   */\n  const completeConnection = (): void => {\n    _state = { type: \"connected\" };\n\n    // Reset reconnection attempt counter on successful connection\n    _reconnectAttempt = 0;\n\n    // Clear connection timeout\n    if (_connectionTimeoutHandle) {\n      clearTimeout(_connectionTimeoutHandle);\n      _connectionTimeoutHandle = null;\n    }\n\n    // Start heartbeat\n    startHeartbeat();\n\n    // Flush any queued messages\n    flushMessageQueue();\n\n    // Resolve connect promise\n    _connectResolver?.();\n    _connectResolver = null;\n    _connectRejecter = null;\n\n    emit(onEvent, { type: \"connected\" });\n  };\n\n  /**\n   * Cleans up WebSocket and related state.\n   */\n  const cleanup = (): void => {\n    clearTimers();\n\n    if (_ws) {\n      // Remove listeners to prevent callbacks\n      _ws.onopen = null;\n      _ws.onclose = null;\n      _ws.onerror = null;\n      _ws.onmessage = null;\n      \n      if (_ws.readyState === WebSocket.OPEN || _ws.readyState === WebSocket.CONNECTING) {\n        _ws.close();\n      }\n      _ws = null;\n    }\n  };\n\n  /**\n   * Handles connection lost - initiates reconnection if enabled.\n   */\n  const handleConnectionLost = (reason?: string): void => {\n    cleanup();\n\n    if (_state.type === \"disconnected\") return;\n\n    const wasInitialConnect = _connectRejecter !== null;\n\n    if (wasInitialConnect) {\n      // Failed during initial connection\n      _state = { type: \"disconnected\" };\n      _reconnectAttempt = 0;\n      _connectRejecter!(new WebSocketError(\"Connection failed\", undefined, reason));\n      _connectResolver = null;\n      _connectRejecter = null;\n      emit(onEvent, { type: \"disconnected\", reason });\n      return;\n    }\n\n    if (!autoReconnect) {\n      _state = { type: \"disconnected\" };\n      _reconnectAttempt = 0;\n      emit(onEvent, { type: \"disconnected\", reason });\n      return;\n    }\n\n    _reconnectAttempt++;\n\n    if (_reconnectAttempt > maxReconnectAttempts) {\n      _state = { type: \"disconnected\" };\n      _reconnectAttempt = 0;\n      emit(onEvent, { type: \"disconnected\", reason: \"Max reconnection attempts reached\" });\n      return;\n    }\n\n    // Enter reconnecting state\n    _state = { type: \"reconnecting\", attempt: _reconnectAttempt };\n    emit(onEvent, { type: \"reconnecting\", attempt: _reconnectAttempt });\n\n    // Schedule reconnection\n    const delay = getReconnectDelay(_reconnectAttempt - 1);\n    _reconnectTimeoutHandle = setTimeout(() => {\n      _reconnectTimeoutHandle = null;\n      attemptConnection();\n    }, delay);\n  };\n\n  /**\n   * Attempts to establish WebSocket connection.\n   */\n  const attemptConnection = (): void => {\n    if (_state.type === \"connected\") return;\n\n    _state = { type: \"connecting\" };\n\n    try {\n      _ws = new WebSocket(url, protocols);\n    } catch (error) {\n      handleConnectionLost((error as Error).message);\n      return;\n    }\n\n    // Set connection timeout\n    _connectionTimeoutHandle = setTimeout(() => {\n      _connectionTimeoutHandle = null;\n      handleConnectionLost(\"Connection timeout\");\n    }, connectionTimeout);\n\n    _ws.onopen = async () => {\n      // Clear connection timeout\n      if (_connectionTimeoutHandle) {\n        clearTimeout(_connectionTimeoutHandle);\n        _connectionTimeoutHandle = null;\n      }\n\n      try {\n        // Always authenticate (even with empty token) to trigger server auth flow\n        await authenticate();\n        // Connection completes after auth_result is received\n      } catch (error) {\n        handleConnectionLost((error as Error).message);\n      }\n    };\n\n    _ws.onclose = (event) => {\n      handleConnectionLost(event.reason || `Connection closed (code: ${event.code})`);\n    };\n\n    _ws.onerror = () => {\n      // Error details come through onclose\n    };\n\n    _ws.onmessage = (event) => {\n      try {\n        const encoded = JSON.parse(event.data as string) as Transport.EncodedServerMessage;\n        const message = decodeServerMessage(encoded);\n        handleMessage(message);\n      } catch {\n        // Invalid message - ignore\n      }\n    };\n  };\n\n  /**\n   * Handles incoming server messages.\n   */\n  const handleMessage = (message: Transport.ServerMessage): void => {\n    // Handle internal messages\n    if (message.type === \"pong\") {\n      handlePong();\n      return;\n    }\n\n    if (message.type === \"auth_result\") {\n      handleAuthResult(message.success, message.error);\n      return;\n    }\n\n    // Forward to subscribers\n    for (const handler of _messageHandlers) {\n      try {\n        handler(message);\n      } catch {\n        // Ignore handler errors\n      }\n    }\n  };\n\n  // ==========================================================================\n  // Public API\n  // ==========================================================================\n\n  const transport: Transport.Transport = {\n    send: (transaction: Transaction.Transaction): void => {\n      const message: Transport.ClientMessage = { type: \"submit\", transaction };\n\n      if (_state.type === \"connected\") {\n        sendRaw(message);\n      } else if (_state.type === \"reconnecting\") {\n        // Queue message for when we reconnect\n        _messageQueue.push(message);\n      }\n      // If disconnected, silently drop (caller should check isConnected)\n    },\n\n    requestSnapshot: (): void => {\n      const message: Transport.ClientMessage = { type: \"request_snapshot\" };\n\n      if (_state.type === \"connected\") {\n        sendRaw(message);\n      } else if (_state.type === \"reconnecting\") {\n        _messageQueue.push(message);\n      }\n    },\n\n    subscribe: (handler: (message: Transport.ServerMessage) => void): (() => void) => {\n      _messageHandlers.add(handler);\n      return () => {\n        _messageHandlers.delete(handler);\n      };\n    },\n\n    connect: async (): Promise<void> => {\n      if (_state.type === \"connected\") {\n        return;\n      }\n\n      if (_state.type === \"connecting\" || _state.type === \"authenticating\") {\n        // Already connecting - wait for existing promise\n        return new Promise((resolve, reject) => {\n          const existingResolver = _connectResolver;\n          const existingRejecter = _connectRejecter;\n          _connectResolver = () => {\n            existingResolver?.();\n            resolve();\n          };\n          _connectRejecter = (error) => {\n            existingRejecter?.(error);\n            reject(error);\n          };\n        });\n      }\n\n      return new Promise((resolve, reject) => {\n        _connectResolver = resolve;\n        _connectRejecter = reject;\n        attemptConnection();\n      });\n    },\n\n    disconnect: (): void => {\n      // Cancel any pending reconnection\n      if (_reconnectTimeoutHandle) {\n        clearTimeout(_reconnectTimeoutHandle);\n        _reconnectTimeoutHandle = null;\n      }\n\n      // Reject any pending connect promise\n      if (_connectRejecter) {\n        _connectRejecter(new WebSocketError(\"Disconnected by user\"));\n        _connectResolver = null;\n        _connectRejecter = null;\n      }\n\n      // Clean up\n      cleanup();\n      _state = { type: \"disconnected\" };\n      _reconnectAttempt = 0;\n      _messageQueue = [];\n\n      emit(onEvent, { type: \"disconnected\", reason: \"User disconnected\" });\n    },\n\n    isConnected: (): boolean => {\n      return _state.type === \"connected\";\n    },\n\n    // =========================================================================\n    // Presence Methods\n    // =========================================================================\n\n    sendPresenceSet: (data: unknown): void => {\n      const message: Transport.ClientMessage = { type: \"presence_set\", data };\n\n      if (_state.type === \"connected\") {\n        sendRaw(message);\n      } else if (_state.type === \"reconnecting\") {\n        // Remove all set messages from the message queue\n        _messageQueue = _messageQueue.filter((message) => message.type !== \"presence_set\");\n        // Add the new presence set message to the queue\n        _messageQueue.push(message);\n      }\n    },\n\n    sendPresenceClear: (): void => {\n      const message: Transport.ClientMessage = { type: \"presence_clear\" };\n\n      if (_state.type === \"connected\") {\n        sendRaw(message);\n      } else if (_state.type === \"reconnecting\") {\n        // Remove all clear messages from the message queue\n        _messageQueue = _messageQueue.filter((message) => message.type !== \"presence_clear\");\n        // Add the new presence clear message to the queue\n        _messageQueue.push(message);\n      }\n    },\n  };\n\n  return transport;\n};\n"],"mappings":"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"}

package/dist/client/errors.cjs

@@ -0,0 +1,135 @@
+const require_defineProperty = require('../_virtual/_@oxc-project_runtime@0.103.0/helpers/defineProperty.cjs');
+
+//#region src/client/errors.ts
+/**
+* Base error class for all mimic-client errors.
+*/
+var MimicClientError = class extends Error {
+	constructor(message) {
+		super(message);
+		require_defineProperty._defineProperty(this, "_tag", "MimicClientError");
+		this.name = "MimicClientError";
+	}
+};
+/**
+* Error thrown when a transaction is rejected by the server.
+*/
+var TransactionRejectedError = class extends MimicClientError {
+	constructor(transaction, reason) {
+		super(`Transaction ${transaction.id} rejected: ${reason}`);
+		require_defineProperty._defineProperty(this, "_tag", "TransactionRejectedError");
+		require_defineProperty._defineProperty(this, "transaction", void 0);
+		require_defineProperty._defineProperty(this, "reason", void 0);
+		this.name = "TransactionRejectedError";
+		this.transaction = transaction;
+		this.reason = reason;
+	}
+};
+/**
+* Error thrown when the transport is not connected.
+*/
+var NotConnectedError = class extends MimicClientError {
+	constructor() {
+		super("Transport is not connected");
+		require_defineProperty._defineProperty(this, "_tag", "NotConnectedError");
+		this.name = "NotConnectedError";
+	}
+};
+/**
+* Error thrown when connection to the server fails.
+*/
+var ConnectionError = class extends MimicClientError {
+	constructor(message, cause) {
+		super(message);
+		require_defineProperty._defineProperty(this, "_tag", "ConnectionError");
+		require_defineProperty._defineProperty(this, "cause", void 0);
+		this.name = "ConnectionError";
+		this.cause = cause;
+	}
+};
+/**
+* Error thrown when state drift is detected and cannot be recovered.
+*/
+var StateDriftError = class extends MimicClientError {
+	constructor(expectedVersion, receivedVersion) {
+		super(`State drift detected: expected version ${expectedVersion}, received ${receivedVersion}`);
+		require_defineProperty._defineProperty(this, "_tag", "StateDriftError");
+		require_defineProperty._defineProperty(this, "expectedVersion", void 0);
+		require_defineProperty._defineProperty(this, "receivedVersion", void 0);
+		this.name = "StateDriftError";
+		this.expectedVersion = expectedVersion;
+		this.receivedVersion = receivedVersion;
+	}
+};
+/**
+* Error thrown when a pending transaction times out waiting for confirmation.
+*/
+var TransactionTimeoutError = class extends MimicClientError {
+	constructor(transaction, timeoutMs) {
+		super(`Transaction ${transaction.id} timed out after ${timeoutMs}ms waiting for confirmation`);
+		require_defineProperty._defineProperty(this, "_tag", "TransactionTimeoutError");
+		require_defineProperty._defineProperty(this, "transaction", void 0);
+		require_defineProperty._defineProperty(this, "timeoutMs", void 0);
+		this.name = "TransactionTimeoutError";
+		this.transaction = transaction;
+		this.timeoutMs = timeoutMs;
+	}
+};
+/**
+* Error thrown when rebasing operations fails.
+*/
+var RebaseError = class extends MimicClientError {
+	constructor(transactionId, message) {
+		super(`Failed to rebase transaction ${transactionId}: ${message}`);
+		require_defineProperty._defineProperty(this, "_tag", "RebaseError");
+		require_defineProperty._defineProperty(this, "transactionId", void 0);
+		this.name = "RebaseError";
+		this.transactionId = transactionId;
+	}
+};
+/**
+* Error thrown when the client document is in an invalid state.
+*/
+var InvalidStateError = class extends MimicClientError {
+	constructor(message) {
+		super(message);
+		require_defineProperty._defineProperty(this, "_tag", "InvalidStateError");
+		this.name = "InvalidStateError";
+	}
+};
+/**
+* Error thrown when WebSocket connection or communication fails.
+*/
+var WebSocketError = class extends MimicClientError {
+	constructor(message, code, reason) {
+		super(message);
+		require_defineProperty._defineProperty(this, "_tag", "WebSocketError");
+		require_defineProperty._defineProperty(this, "code", void 0);
+		require_defineProperty._defineProperty(this, "reason", void 0);
+		this.name = "WebSocketError";
+		this.code = code;
+		this.reason = reason;
+	}
+};
+/**
+* Error thrown when authentication fails.
+*/
+var AuthenticationError = class extends MimicClientError {
+	constructor(message) {
+		super(message);
+		require_defineProperty._defineProperty(this, "_tag", "AuthenticationError");
+		this.name = "AuthenticationError";
+	}
+};
+
+//#endregion
+exports.AuthenticationError = AuthenticationError;
+exports.ConnectionError = ConnectionError;
+exports.InvalidStateError = InvalidStateError;
+exports.MimicClientError = MimicClientError;
+exports.NotConnectedError = NotConnectedError;
+exports.RebaseError = RebaseError;
+exports.StateDriftError = StateDriftError;
+exports.TransactionRejectedError = TransactionRejectedError;
+exports.TransactionTimeoutError = TransactionTimeoutError;
+exports.WebSocketError = WebSocketError;

package/dist/client/errors.d.cts

@@ -0,0 +1,87 @@
+import { Transaction } from "../Transaction.cjs";
+
+//#region src/client/errors.d.ts
+
+/**
+ * Base error class for all mimic-client errors.
+ */
+declare class MimicClientError extends Error {
+  readonly _tag: string;
+  constructor(message: string);
+}
+/**
+ * Error thrown when a transaction is rejected by the server.
+ */
+declare class TransactionRejectedError extends MimicClientError {
+  readonly _tag = "TransactionRejectedError";
+  readonly transaction: Transaction;
+  readonly reason: string;
+  constructor(transaction: Transaction, reason: string);
+}
+/**
+ * Error thrown when the transport is not connected.
+ */
+declare class NotConnectedError extends MimicClientError {
+  readonly _tag = "NotConnectedError";
+  constructor();
+}
+/**
+ * Error thrown when connection to the server fails.
+ */
+declare class ConnectionError extends MimicClientError {
+  readonly _tag = "ConnectionError";
+  readonly cause?: Error;
+  constructor(message: string, cause?: Error);
+}
+/**
+ * Error thrown when state drift is detected and cannot be recovered.
+ */
+declare class StateDriftError extends MimicClientError {
+  readonly _tag = "StateDriftError";
+  readonly expectedVersion: number;
+  readonly receivedVersion: number;
+  constructor(expectedVersion: number, receivedVersion: number);
+}
+/**
+ * Error thrown when a pending transaction times out waiting for confirmation.
+ */
+declare class TransactionTimeoutError extends MimicClientError {
+  readonly _tag = "TransactionTimeoutError";
+  readonly transaction: Transaction;
+  readonly timeoutMs: number;
+  constructor(transaction: Transaction, timeoutMs: number);
+}
+/**
+ * Error thrown when rebasing operations fails.
+ */
+declare class RebaseError extends MimicClientError {
+  readonly _tag = "RebaseError";
+  readonly transactionId: string;
+  constructor(transactionId: string, message: string);
+}
+/**
+ * Error thrown when the client document is in an invalid state.
+ */
+declare class InvalidStateError extends MimicClientError {
+  readonly _tag = "InvalidStateError";
+  constructor(message: string);
+}
+/**
+ * Error thrown when WebSocket connection or communication fails.
+ */
+declare class WebSocketError extends MimicClientError {
+  readonly _tag = "WebSocketError";
+  readonly code?: number;
+  readonly reason?: string;
+  constructor(message: string, code?: number, reason?: string);
+}
+/**
+ * Error thrown when authentication fails.
+ */
+declare class AuthenticationError extends MimicClientError {
+  readonly _tag = "AuthenticationError";
+  constructor(message: string);
+}
+//#endregion
+export { AuthenticationError, ConnectionError, InvalidStateError, MimicClientError, NotConnectedError, RebaseError, StateDriftError, TransactionRejectedError, TransactionTimeoutError, WebSocketError };
+//# sourceMappingURL=errors.d.cts.map

package/dist/client/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":[],"mappings":";;;;;;AASA;AAWa,cAXA,gBAAA,SAAyB,KAAA,CAWA;EAEd,SAAA,IAAA,EAAA,MAAA;EAGG,WAAA,CAAA,OAAA,EAAA,MAAA;;;AAW3B;AAWA;AAE4B,cA7Bf,wBAAA,SAAiC,gBAAA,CA6BlB;EAEW,SAAA,IAAA,GAAA,0BAAA;EAJF,SAAA,WAAA,EAzBb,WAyBa;EAAgB,SAAA,MAAA,EAAA,MAAA;EAcxC,WAAA,CAAA,WAAgB,EApCF,WAoC0B,EAAA,MAAA,EAAA,MAAA;AAkBrD;;;;AAA6D,cA3ChD,iBAAA,SAA0B,gBAAA,CA2CsB;EAkBhD,SAAA,IAAA,GAAY,mBAAQ;EAcpB,WAAA,CAAA;AAWb;AAgBA;;;cA3Fa,eAAA,SAAwB,gBAAA;;mBAET;uCAEW;;;;;cAU1B,eAAA,SAAwB,gBAAA;;;;;;;;;cAkBxB,uBAAA,SAAgC,gBAAA;;wBAErB;;2BAGG;;;;;cAad,WAAA,SAAoB,gBAAA;;;;;;;;cAcpB,iBAAA,SAA0B,gBAAA;;;;;;;cAW1B,cAAA,SAAuB,gBAAA;;;;;;;;;cAgBvB,mBAAA,SAA4B,gBAAA"}