verani 0.1.6 → 0.1.8

package/dist/client.cjs

@@ -0,0 +1 @@
+const require_types=require(`./types-083oWz55.cjs`);function encodeClientMessage$1(t){return require_types.n(t)}function decodeServerMessage$1(t){return require_types.s(t)}const DEFAULT_RECONNECTION_CONFIG={enabled:!0,maxAttempts:10,initialDelay:1e3,maxDelay:3e4,backoffMultiplier:1.5};var ConnectionManager=class{constructor(e=DEFAULT_RECONNECTION_CONFIG,t){this.config=e,this.onStateChange=t,this.state=`disconnected`,this.reconnectAttempts=0,this.currentDelay=e.initialDelay}getState(){return this.state}isValidStateTransition(e,t){return{disconnected:[`connecting`,`reconnecting`],connecting:[`connected`,`disconnected`,`error`,`reconnecting`],connected:[`disconnected`,`reconnecting`],reconnecting:[`connecting`,`disconnected`,`error`],error:[`reconnecting`,`disconnected`,`connecting`]}[e]?.includes(t)??!1}setState(e){this.state!==e&&(this.isValidStateTransition(this.state,e),this.state=e,this.onStateChange?.(e))}resetReconnection(){this.reconnectAttempts=0,this.currentDelay=this.config.initialDelay,this.clearReconnectTimer()}scheduleReconnect(e){return this.config.enabled?this.config.maxAttempts>0&&this.reconnectAttempts>=this.config.maxAttempts?(this.setState(`error`),!1):(this.clearReconnectTimer(),this.setState(`reconnecting`),this.reconnectAttempts++,this.reconnectTimer=setTimeout(()=>{e(),this.currentDelay=Math.min(this.currentDelay*this.config.backoffMultiplier,this.config.maxDelay)},this.currentDelay),!0):!1}cancelReconnect(){this.clearReconnectTimer(),this.state===`reconnecting`&&this.setState(`disconnected`)}clearReconnectTimer(){this.reconnectTimer!==void 0&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=void 0)}getReconnectAttempts(){return this.reconnectAttempts}getNextDelay(){return this.currentDelay}destroy(){this.clearReconnectTimer()}},VeraniClient=class{constructor(e,t={}){this.url=e,this.listeners=new Map,this.messageQueue=[],this.isConnecting=!1,this.connectionId=0,this.options={reconnection:{enabled:t.reconnection?.enabled??DEFAULT_RECONNECTION_CONFIG.enabled,maxAttempts:t.reconnection?.maxAttempts??DEFAULT_RECONNECTION_CONFIG.maxAttempts,initialDelay:t.reconnection?.initialDelay??DEFAULT_RECONNECTION_CONFIG.initialDelay,maxDelay:t.reconnection?.maxDelay??DEFAULT_RECONNECTION_CONFIG.maxDelay,backoffMultiplier:t.reconnection?.backoffMultiplier??DEFAULT_RECONNECTION_CONFIG.backoffMultiplier},maxQueueSize:t.maxQueueSize??100,connectionTimeout:t.connectionTimeout??1e4},this.connectionManager=new ConnectionManager(this.options.reconnection,e=>{this.onStateChangeCallback?.(e)}),this.connect()}cleanupWebSocket(){if(this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.ws){let e=this.ws;if(this.ws=void 0,e.readyState===WebSocket.OPEN||e.readyState===WebSocket.CONNECTING)try{e.close(1e3,`Cleanup`)}catch{}}}connect(){if(!this.isConnecting&&!this.isConnected()){this.cleanupWebSocket();try{this.isConnecting=!0,this.connectionId++;let e=this.connectionId;this.connectionManager.setState(`connecting`),this.emitLifecycleEvent(`connecting`),this.ws=new WebSocket(this.url),this.connectionTimeout=setTimeout(()=>{this.isConnecting&&this.connectionId===e&&(this.ws?.close(),this.handleConnectionError(Error(`Connection timeout`)))},this.options.connectionTimeout),this.ws.addEventListener(`open`,()=>{this.connectionId===e&&this.handleOpen()}),this.ws.addEventListener(`message`,t=>{this.connectionId===e&&this.handleMessage(t)}),this.ws.addEventListener(`close`,t=>{this.connectionId===e&&this.handleClose(t)}),this.ws.addEventListener(`error`,t=>{this.connectionId===e&&this.handleError(t)})}catch(e){this.isConnecting=!1,this.handleConnectionError(e)}}}handleOpen(){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.connectionManager.setState(`connected`),this.connectionManager.resetReconnection(),this.flushMessageQueue(),this.connectionResolve&&(this.connectionResolve(),this.connectionPromise=void 0,this.connectionResolve=void 0,this.connectionReject=void 0),this.emitLifecycleEvent(`open`),this.emitLifecycleEvent(`connected`),this.onOpenCallback?.()}handleMessage(e){let t=decodeServerMessage$1(e.data);if(!t)return;let r=t.type,i=t.data;t.type===`event`&&t.data&&typeof t.data==`object`&&`type`in t.data&&(r=t.data.type,i=t.data);let a=this.listeners.get(r);if(a)for(let e of a)try{e(i)}catch{}}handleClose(e){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.connectionManager.setState(`disconnected`),this.connectionReject&&=(this.connectionReject(Error(`Connection closed: ${e.reason||`Unknown reason`}`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.emitLifecycleEvent(`close`,e),this.emitLifecycleEvent(`disconnected`,e),this.onCloseCallback?.(e),e.code!==1e3&&e.code!==1001&&this.connectionManager.scheduleReconnect(()=>this.connect())&&this.emitLifecycleEvent(`reconnecting`)}handleError(e){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.emitLifecycleEvent(`error`,e),this.onErrorCallback?.(e),this.handleConnectionError(Error(`WebSocket error`))}handleConnectionError(e){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.connectionReject&&=(this.connectionReject(e),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.emitLifecycleEvent(`error`,e),this.connectionManager.scheduleReconnect(()=>this.connect())&&this.emitLifecycleEvent(`reconnecting`)}emitLifecycleEvent(e,t){let n=this.listeners.get(e);if(n)for(let e of n)try{e(t)}catch{}}flushMessageQueue(){if(!(!this.ws||this.ws.readyState!==WebSocket.OPEN))for(;this.messageQueue.length>0;){let e=this.messageQueue.shift();try{this.ws.send(encodeClientMessage$1(e))}catch{}}}getState(){return this.connectionManager.getState()}isConnected(){return this.ws?.readyState===WebSocket.OPEN&&this.connectionManager.getState()===`connected`}getConnectionState(){return{state:this.connectionManager.getState(),isConnected:this.isConnected(),isConnecting:this.isConnecting,reconnectAttempts:this.connectionManager.getReconnectAttempts(),connectionId:this.connectionId}}waitForConnection(){return this.isConnected()?Promise.resolve():(this.connectionPromise||=new Promise((e,t)=>{this.connectionResolve=e,this.connectionReject=t;let n=setTimeout(()=>{this.connectionReject&&=(this.connectionReject(Error(`Connection wait timeout`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0)},this.options.connectionTimeout*2);this.connectionPromise&&this.connectionPromise.finally(()=>{clearTimeout(n)})}),this.connectionPromise)}on(e,t){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(t)}off(e,t){let n=this.listeners.get(e);n&&(n.delete(t),n.size===0&&this.listeners.delete(e))}once(e,t){let n=r=>{this.off(e,n),t(r)};this.on(e,n)}emit(e,n){let r={type:e,data:n};if(this.isConnected())try{this.ws.send(encodeClientMessage$1(r))}catch{this.queueMessage(r)}else this.queueMessage(r)}queueMessage(e){this.messageQueue.length>=this.options.maxQueueSize&&this.messageQueue.shift(),this.messageQueue.push(e)}onOpen(e){this.onOpenCallback=e}onClose(e){this.onCloseCallback=e}onError(e){this.onErrorCallback=e}onStateChange(e){this.onStateChangeCallback=e}reconnect(){this.connectionManager.resetReconnection(),this.connectionManager.cancelReconnect(),this.cleanupWebSocket(),this.isConnecting=!1,this.connectionManager.setState(`disconnected`),this.connect()}disconnect(){this.connectionManager.cancelReconnect(),this.isConnecting=!1,this.connectionReject&&=(this.connectionReject(Error(`Connection disconnected`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.cleanupWebSocket(),this.connectionManager.setState(`disconnected`)}close(){this.connectionReject&&=(this.connectionReject(Error(`Client closed`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.disconnect(),this.listeners.clear(),this.messageQueue=[],this.connectionManager.destroy()}};exports.ConnectionManager=ConnectionManager,exports.DEFAULT_RECONNECTION_CONFIG=DEFAULT_RECONNECTION_CONFIG,exports.PROTOCOL_VERSION=require_types.t,exports.VeraniClient=VeraniClient,exports.decodeClientMessage=require_types.a,exports.decodeFrame=require_types.o,exports.decodeServerMessage=require_types.s,exports.encodeClientMessage=require_types.n,exports.encodeFrame=require_types.r,exports.encodeServerMessage=require_types.i;

package/dist/client.d.cts

@@ -0,0 +1,229 @@
+import { a as encodeFrame, d as ServerMessage, f as VeraniMessage, i as encodeClientMessage, n as decodeFrame, o as encodeServerMessage, r as decodeServerMessage, s as ClientMessage, t as decodeClientMessage, u as PROTOCOL_VERSION } from "./decode-DMA_rBWB.cjs";
+
+//#region src/client/connection.d.ts
+/**
+ * Connection state management for Verani client
+ */
+type ConnectionState = "connecting" | "connected" | "disconnected" | "reconnecting" | "error";
+interface ReconnectionConfig {
+  /** Enable automatic reconnection */
+  enabled: boolean;
+  /** Maximum number of reconnection attempts (0 = infinite) */
+  maxAttempts: number;
+  /** Initial delay in milliseconds */
+  initialDelay: number;
+  /** Maximum delay in milliseconds */
+  maxDelay: number;
+  /** Backoff multiplier for exponential backoff */
+  backoffMultiplier: number;
+}
+declare const DEFAULT_RECONNECTION_CONFIG: ReconnectionConfig;
+/**
+ * Manages WebSocket connection lifecycle and reconnection logic
+ */
+declare class ConnectionManager {
+  private config;
+  private onStateChange?;
+  private state;
+  private reconnectAttempts;
+  private reconnectTimer?;
+  private currentDelay;
+  constructor(config?: ReconnectionConfig, onStateChange?: ((state: ConnectionState) => void) | undefined);
+  /**
+   * Gets the current connection state
+   */
+  getState(): ConnectionState;
+  /**
+   * Validates if a state transition is valid
+   */
+  private isValidStateTransition;
+  /**
+   * Updates the connection state and notifies listeners
+   */
+  setState(newState: ConnectionState): void;
+  /**
+   * Resets reconnection state (called on successful connection)
+   */
+  resetReconnection(): void;
+  /**
+   * Schedules a reconnection attempt
+   */
+  scheduleReconnect(connectFn: () => void): boolean;
+  /**
+   * Cancels any pending reconnection
+   */
+  cancelReconnect(): void;
+  /**
+   * Clears the reconnect timer
+   */
+  private clearReconnectTimer;
+  /**
+   * Gets the current reconnection attempt count
+   */
+  getReconnectAttempts(): number;
+  /**
+   * Gets the next reconnection delay
+   */
+  getNextDelay(): number;
+  /**
+   * Cleanup method
+   */
+  destroy(): void;
+}
+//#endregion
+//#region src/client/client.d.ts
+/**
+ * Client options for configuring the Verani client
+ */
+interface VeraniClientOptions {
+  /** Reconnection configuration */
+  reconnection?: Partial<ReconnectionConfig>;
+  /** Maximum number of messages to queue when disconnected */
+  maxQueueSize?: number;
+  /** Connection timeout in milliseconds */
+  connectionTimeout?: number;
+}
+/**
+ * Verani WebSocket client with automatic reconnection and lifecycle management
+ */
+declare class VeraniClient {
+  private url;
+  private ws?;
+  private listeners;
+  private connectionManager;
+  private messageQueue;
+  private options;
+  private onOpenCallback?;
+  private onCloseCallback?;
+  private onErrorCallback?;
+  private onStateChangeCallback?;
+  private connectionPromise?;
+  private connectionResolve?;
+  private connectionReject?;
+  private connectionTimeout?;
+  private isConnecting;
+  private connectionId;
+  /**
+   * Creates a new Verani client
+   * @param url - WebSocket URL to connect to
+   * @param options - Client configuration options
+   */
+  constructor(url: string, options?: VeraniClientOptions);
+  /**
+   * Cleans up existing WebSocket connection and resources
+   */
+  private cleanupWebSocket;
+  /**
+   * Establishes WebSocket connection
+   */
+  private connect;
+  /**
+   * Handles successful WebSocket connection
+   */
+  private handleOpen;
+  /**
+   * Handles incoming WebSocket messages
+   */
+  private handleMessage;
+  /**
+   * Handles WebSocket closure
+   */
+  private handleClose;
+  /**
+   * Handles WebSocket errors
+   */
+  private handleError;
+  /**
+   * Handles connection errors
+   */
+  private handleConnectionError;
+  /**
+   * Emits a lifecycle event to registered listeners
+   */
+  private emitLifecycleEvent;
+  /**
+   * Flushes queued messages when connection is established
+   */
+  private flushMessageQueue;
+  /**
+   * Gets the current connection state
+   */
+  getState(): ConnectionState;
+  /**
+   * Checks if the client is currently connected
+   */
+  isConnected(): boolean;
+  /**
+   * Gets detailed connection information
+   */
+  getConnectionState(): {
+    state: ConnectionState;
+    isConnected: boolean;
+    isConnecting: boolean;
+    reconnectAttempts: number;
+    connectionId: number;
+  };
+  /**
+   * Waits for the connection to be established
+   * @returns Promise that resolves when connected
+   */
+  waitForConnection(): Promise<void>;
+  /**
+   * Registers an event listener
+   * @param event - Event type to listen for
+   * @param callback - Callback function to invoke when event is received
+   */
+  on(event: string, callback: (data: any) => void): void;
+  /**
+   * Removes an event listener
+   * @param event - Event type to remove listener from
+   * @param callback - Callback function to remove
+   */
+  off(event: string, callback: (data: any) => void): void;
+  /**
+   * Registers a one-time event listener
+   * @param event - Event type to listen for
+   * @param callback - Callback function to invoke once
+   */
+  once(event: string, callback: (data: any) => void): void;
+  /**
+   * Sends a message to the server
+   * @param type - Message type
+   * @param data - Optional message data
+   */
+  emit(type: string, data?: any): void;
+  /**
+   * Queues a message for sending when connected
+   */
+  private queueMessage;
+  /**
+   * Registers lifecycle callback for connection open
+   */
+  onOpen(callback: () => void): void;
+  /**
+   * Registers lifecycle callback for connection close
+   */
+  onClose(callback: (event: CloseEvent) => void): void;
+  /**
+   * Registers lifecycle callback for connection error
+   */
+  onError(callback: (error: Event) => void): void;
+  /**
+   * Registers lifecycle callback for state changes
+   */
+  onStateChange(callback: (state: ConnectionState) => void): void;
+  /**
+   * Manually triggers a reconnection
+   */
+  reconnect(): void;
+  /**
+   * Closes the connection without reconnecting
+   */
+  disconnect(): void;
+  /**
+   * Closes the connection and cleans up resources
+   */
+  close(): void;
+}
+//#endregion
+export { type ClientMessage, ConnectionManager, type ConnectionState, DEFAULT_RECONNECTION_CONFIG, PROTOCOL_VERSION, type ReconnectionConfig, type ServerMessage, VeraniClient, type VeraniClientOptions, type VeraniMessage, decodeClientMessage, decodeFrame, decodeServerMessage, encodeClientMessage, encodeFrame, encodeServerMessage };

package/dist/client.d.mts

@@ -0,0 +1,229 @@
+import { a as encodeFrame, d as ServerMessage, f as VeraniMessage, i as encodeClientMessage, n as decodeFrame, o as encodeServerMessage, r as decodeServerMessage, s as ClientMessage, t as decodeClientMessage, u as PROTOCOL_VERSION } from "./decode-9DerwlQ1.mjs";
+
+//#region src/client/connection.d.ts
+/**
+ * Connection state management for Verani client
+ */
+type ConnectionState = "connecting" | "connected" | "disconnected" | "reconnecting" | "error";
+interface ReconnectionConfig {
+  /** Enable automatic reconnection */
+  enabled: boolean;
+  /** Maximum number of reconnection attempts (0 = infinite) */
+  maxAttempts: number;
+  /** Initial delay in milliseconds */
+  initialDelay: number;
+  /** Maximum delay in milliseconds */
+  maxDelay: number;
+  /** Backoff multiplier for exponential backoff */
+  backoffMultiplier: number;
+}
+declare const DEFAULT_RECONNECTION_CONFIG: ReconnectionConfig;
+/**
+ * Manages WebSocket connection lifecycle and reconnection logic
+ */
+declare class ConnectionManager {
+  private config;
+  private onStateChange?;
+  private state;
+  private reconnectAttempts;
+  private reconnectTimer?;
+  private currentDelay;
+  constructor(config?: ReconnectionConfig, onStateChange?: ((state: ConnectionState) => void) | undefined);
+  /**
+   * Gets the current connection state
+   */
+  getState(): ConnectionState;
+  /**
+   * Validates if a state transition is valid
+   */
+  private isValidStateTransition;
+  /**
+   * Updates the connection state and notifies listeners
+   */
+  setState(newState: ConnectionState): void;
+  /**
+   * Resets reconnection state (called on successful connection)
+   */
+  resetReconnection(): void;
+  /**
+   * Schedules a reconnection attempt
+   */
+  scheduleReconnect(connectFn: () => void): boolean;
+  /**
+   * Cancels any pending reconnection
+   */
+  cancelReconnect(): void;
+  /**
+   * Clears the reconnect timer
+   */
+  private clearReconnectTimer;
+  /**
+   * Gets the current reconnection attempt count
+   */
+  getReconnectAttempts(): number;
+  /**
+   * Gets the next reconnection delay
+   */
+  getNextDelay(): number;
+  /**
+   * Cleanup method
+   */
+  destroy(): void;
+}
+//#endregion
+//#region src/client/client.d.ts
+/**
+ * Client options for configuring the Verani client
+ */
+interface VeraniClientOptions {
+  /** Reconnection configuration */
+  reconnection?: Partial<ReconnectionConfig>;
+  /** Maximum number of messages to queue when disconnected */
+  maxQueueSize?: number;
+  /** Connection timeout in milliseconds */
+  connectionTimeout?: number;
+}
+/**
+ * Verani WebSocket client with automatic reconnection and lifecycle management
+ */
+declare class VeraniClient {
+  private url;
+  private ws?;
+  private listeners;
+  private connectionManager;
+  private messageQueue;
+  private options;
+  private onOpenCallback?;
+  private onCloseCallback?;
+  private onErrorCallback?;
+  private onStateChangeCallback?;
+  private connectionPromise?;
+  private connectionResolve?;
+  private connectionReject?;
+  private connectionTimeout?;
+  private isConnecting;
+  private connectionId;
+  /**
+   * Creates a new Verani client
+   * @param url - WebSocket URL to connect to
+   * @param options - Client configuration options
+   */
+  constructor(url: string, options?: VeraniClientOptions);
+  /**
+   * Cleans up existing WebSocket connection and resources
+   */
+  private cleanupWebSocket;
+  /**
+   * Establishes WebSocket connection
+   */
+  private connect;
+  /**
+   * Handles successful WebSocket connection
+   */
+  private handleOpen;
+  /**
+   * Handles incoming WebSocket messages
+   */
+  private handleMessage;
+  /**
+   * Handles WebSocket closure
+   */
+  private handleClose;
+  /**
+   * Handles WebSocket errors
+   */
+  private handleError;
+  /**
+   * Handles connection errors
+   */
+  private handleConnectionError;
+  /**
+   * Emits a lifecycle event to registered listeners
+   */
+  private emitLifecycleEvent;
+  /**
+   * Flushes queued messages when connection is established
+   */
+  private flushMessageQueue;
+  /**
+   * Gets the current connection state
+   */
+  getState(): ConnectionState;
+  /**
+   * Checks if the client is currently connected
+   */
+  isConnected(): boolean;
+  /**
+   * Gets detailed connection information
+   */
+  getConnectionState(): {
+    state: ConnectionState;
+    isConnected: boolean;
+    isConnecting: boolean;
+    reconnectAttempts: number;
+    connectionId: number;
+  };
+  /**
+   * Waits for the connection to be established
+   * @returns Promise that resolves when connected
+   */
+  waitForConnection(): Promise<void>;
+  /**
+   * Registers an event listener
+   * @param event - Event type to listen for
+   * @param callback - Callback function to invoke when event is received
+   */
+  on(event: string, callback: (data: any) => void): void;
+  /**
+   * Removes an event listener
+   * @param event - Event type to remove listener from
+   * @param callback - Callback function to remove
+   */
+  off(event: string, callback: (data: any) => void): void;
+  /**
+   * Registers a one-time event listener
+   * @param event - Event type to listen for
+   * @param callback - Callback function to invoke once
+   */
+  once(event: string, callback: (data: any) => void): void;
+  /**
+   * Sends a message to the server
+   * @param type - Message type
+   * @param data - Optional message data
+   */
+  emit(type: string, data?: any): void;
+  /**
+   * Queues a message for sending when connected
+   */
+  private queueMessage;
+  /**
+   * Registers lifecycle callback for connection open
+   */
+  onOpen(callback: () => void): void;
+  /**
+   * Registers lifecycle callback for connection close
+   */
+  onClose(callback: (event: CloseEvent) => void): void;
+  /**
+   * Registers lifecycle callback for connection error
+   */
+  onError(callback: (error: Event) => void): void;
+  /**
+   * Registers lifecycle callback for state changes
+   */
+  onStateChange(callback: (state: ConnectionState) => void): void;
+  /**
+   * Manually triggers a reconnection
+   */
+  reconnect(): void;
+  /**
+   * Closes the connection without reconnecting
+   */
+  disconnect(): void;
+  /**
+   * Closes the connection and cleans up resources
+   */
+  close(): void;
+}
+//#endregion
+export { type ClientMessage, ConnectionManager, type ConnectionState, DEFAULT_RECONNECTION_CONFIG, PROTOCOL_VERSION, type ReconnectionConfig, type ServerMessage, VeraniClient, type VeraniClientOptions, type VeraniMessage, decodeClientMessage, decodeFrame, decodeServerMessage, encodeClientMessage, encodeFrame, encodeServerMessage };

package/dist/client.mjs

@@ -0,0 +1 @@
+import{a as decodeClientMessage,i as encodeServerMessage,n as encodeClientMessage,o as decodeFrame,r as encodeFrame,s as decodeServerMessage,t as PROTOCOL_VERSION}from"./types-CJLnZrA8.mjs";function encodeClientMessage$1(e){return encodeClientMessage(e)}function decodeServerMessage$1(e){return decodeServerMessage(e)}const DEFAULT_RECONNECTION_CONFIG={enabled:!0,maxAttempts:10,initialDelay:1e3,maxDelay:3e4,backoffMultiplier:1.5};var ConnectionManager=class{constructor(e=DEFAULT_RECONNECTION_CONFIG,c){this.config=e,this.onStateChange=c,this.state=`disconnected`,this.reconnectAttempts=0,this.currentDelay=e.initialDelay}getState(){return this.state}isValidStateTransition(e,c){return{disconnected:[`connecting`,`reconnecting`],connecting:[`connected`,`disconnected`,`error`,`reconnecting`],connected:[`disconnected`,`reconnecting`],reconnecting:[`connecting`,`disconnected`,`error`],error:[`reconnecting`,`disconnected`,`connecting`]}[e]?.includes(c)??!1}setState(e){this.state!==e&&(this.isValidStateTransition(this.state,e),this.state=e,this.onStateChange?.(e))}resetReconnection(){this.reconnectAttempts=0,this.currentDelay=this.config.initialDelay,this.clearReconnectTimer()}scheduleReconnect(e){return this.config.enabled?this.config.maxAttempts>0&&this.reconnectAttempts>=this.config.maxAttempts?(this.setState(`error`),!1):(this.clearReconnectTimer(),this.setState(`reconnecting`),this.reconnectAttempts++,this.reconnectTimer=setTimeout(()=>{e(),this.currentDelay=Math.min(this.currentDelay*this.config.backoffMultiplier,this.config.maxDelay)},this.currentDelay),!0):!1}cancelReconnect(){this.clearReconnectTimer(),this.state===`reconnecting`&&this.setState(`disconnected`)}clearReconnectTimer(){this.reconnectTimer!==void 0&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=void 0)}getReconnectAttempts(){return this.reconnectAttempts}getNextDelay(){return this.currentDelay}destroy(){this.clearReconnectTimer()}},VeraniClient=class{constructor(e,c={}){this.url=e,this.listeners=new Map,this.messageQueue=[],this.isConnecting=!1,this.connectionId=0,this.options={reconnection:{enabled:c.reconnection?.enabled??DEFAULT_RECONNECTION_CONFIG.enabled,maxAttempts:c.reconnection?.maxAttempts??DEFAULT_RECONNECTION_CONFIG.maxAttempts,initialDelay:c.reconnection?.initialDelay??DEFAULT_RECONNECTION_CONFIG.initialDelay,maxDelay:c.reconnection?.maxDelay??DEFAULT_RECONNECTION_CONFIG.maxDelay,backoffMultiplier:c.reconnection?.backoffMultiplier??DEFAULT_RECONNECTION_CONFIG.backoffMultiplier},maxQueueSize:c.maxQueueSize??100,connectionTimeout:c.connectionTimeout??1e4},this.connectionManager=new ConnectionManager(this.options.reconnection,e=>{this.onStateChangeCallback?.(e)}),this.connect()}cleanupWebSocket(){if(this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.ws){let e=this.ws;if(this.ws=void 0,e.readyState===WebSocket.OPEN||e.readyState===WebSocket.CONNECTING)try{e.close(1e3,`Cleanup`)}catch{}}}connect(){if(!this.isConnecting&&!this.isConnected()){this.cleanupWebSocket();try{this.isConnecting=!0,this.connectionId++;let e=this.connectionId;this.connectionManager.setState(`connecting`),this.emitLifecycleEvent(`connecting`),this.ws=new WebSocket(this.url),this.connectionTimeout=setTimeout(()=>{this.isConnecting&&this.connectionId===e&&(this.ws?.close(),this.handleConnectionError(Error(`Connection timeout`)))},this.options.connectionTimeout),this.ws.addEventListener(`open`,()=>{this.connectionId===e&&this.handleOpen()}),this.ws.addEventListener(`message`,c=>{this.connectionId===e&&this.handleMessage(c)}),this.ws.addEventListener(`close`,c=>{this.connectionId===e&&this.handleClose(c)}),this.ws.addEventListener(`error`,c=>{this.connectionId===e&&this.handleError(c)})}catch(e){this.isConnecting=!1,this.handleConnectionError(e)}}}handleOpen(){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.connectionManager.setState(`connected`),this.connectionManager.resetReconnection(),this.flushMessageQueue(),this.connectionResolve&&(this.connectionResolve(),this.connectionPromise=void 0,this.connectionResolve=void 0,this.connectionReject=void 0),this.emitLifecycleEvent(`open`),this.emitLifecycleEvent(`connected`),this.onOpenCallback?.()}handleMessage(e){let c=decodeServerMessage$1(e.data);if(!c)return;let l=c.type,u=c.data;c.type===`event`&&c.data&&typeof c.data==`object`&&`type`in c.data&&(l=c.data.type,u=c.data);let d=this.listeners.get(l);if(d)for(let e of d)try{e(u)}catch{}}handleClose(e){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.connectionManager.setState(`disconnected`),this.connectionReject&&=(this.connectionReject(Error(`Connection closed: ${e.reason||`Unknown reason`}`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.emitLifecycleEvent(`close`,e),this.emitLifecycleEvent(`disconnected`,e),this.onCloseCallback?.(e),e.code!==1e3&&e.code!==1001&&this.connectionManager.scheduleReconnect(()=>this.connect())&&this.emitLifecycleEvent(`reconnecting`)}handleError(e){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.emitLifecycleEvent(`error`,e),this.onErrorCallback?.(e),this.handleConnectionError(Error(`WebSocket error`))}handleConnectionError(e){this.isConnecting=!1,this.connectionTimeout!==void 0&&(clearTimeout(this.connectionTimeout),this.connectionTimeout=void 0),this.connectionReject&&=(this.connectionReject(e),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.emitLifecycleEvent(`error`,e),this.connectionManager.scheduleReconnect(()=>this.connect())&&this.emitLifecycleEvent(`reconnecting`)}emitLifecycleEvent(e,c){let l=this.listeners.get(e);if(l)for(let e of l)try{e(c)}catch{}}flushMessageQueue(){if(!(!this.ws||this.ws.readyState!==WebSocket.OPEN))for(;this.messageQueue.length>0;){let e=this.messageQueue.shift();try{this.ws.send(encodeClientMessage$1(e))}catch{}}}getState(){return this.connectionManager.getState()}isConnected(){return this.ws?.readyState===WebSocket.OPEN&&this.connectionManager.getState()===`connected`}getConnectionState(){return{state:this.connectionManager.getState(),isConnected:this.isConnected(),isConnecting:this.isConnecting,reconnectAttempts:this.connectionManager.getReconnectAttempts(),connectionId:this.connectionId}}waitForConnection(){return this.isConnected()?Promise.resolve():(this.connectionPromise||=new Promise((e,c)=>{this.connectionResolve=e,this.connectionReject=c;let l=setTimeout(()=>{this.connectionReject&&=(this.connectionReject(Error(`Connection wait timeout`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0)},this.options.connectionTimeout*2);this.connectionPromise&&this.connectionPromise.finally(()=>{clearTimeout(l)})}),this.connectionPromise)}on(e,c){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(c)}off(e,c){let l=this.listeners.get(e);l&&(l.delete(c),l.size===0&&this.listeners.delete(e))}once(e,c){let l=u=>{this.off(e,l),c(u)};this.on(e,l)}emit(e,c){let l={type:e,data:c};if(this.isConnected())try{this.ws.send(encodeClientMessage$1(l))}catch{this.queueMessage(l)}else this.queueMessage(l)}queueMessage(e){this.messageQueue.length>=this.options.maxQueueSize&&this.messageQueue.shift(),this.messageQueue.push(e)}onOpen(e){this.onOpenCallback=e}onClose(e){this.onCloseCallback=e}onError(e){this.onErrorCallback=e}onStateChange(e){this.onStateChangeCallback=e}reconnect(){this.connectionManager.resetReconnection(),this.connectionManager.cancelReconnect(),this.cleanupWebSocket(),this.isConnecting=!1,this.connectionManager.setState(`disconnected`),this.connect()}disconnect(){this.connectionManager.cancelReconnect(),this.isConnecting=!1,this.connectionReject&&=(this.connectionReject(Error(`Connection disconnected`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.cleanupWebSocket(),this.connectionManager.setState(`disconnected`)}close(){this.connectionReject&&=(this.connectionReject(Error(`Client closed`)),this.connectionPromise=void 0,this.connectionResolve=void 0,void 0),this.disconnect(),this.listeners.clear(),this.messageQueue=[],this.connectionManager.destroy()}};export{ConnectionManager,DEFAULT_RECONNECTION_CONFIG,PROTOCOL_VERSION,VeraniClient,decodeClientMessage,decodeFrame,decodeServerMessage,encodeClientMessage,encodeFrame,encodeServerMessage};

package/dist/decode-9DerwlQ1.d.mts

@@ -0,0 +1,87 @@
+//#region src/shared/types.d.ts
+/**
+ * Core message types shared between client and server
+ */
+/**
+ * Base message frame structure used for all WebSocket communication
+ */
+interface MessageFrame {
+  type: string;
+  channel?: string;
+  data?: any;
+}
+/**
+ * Message sent from client to server
+ */
+interface ClientMessage extends MessageFrame {
+  type: string;
+  channel?: string;
+  data?: any;
+}
+/**
+ * Message sent from server to client
+ */
+interface ServerMessage extends MessageFrame {
+  type: string;
+  channel?: string;
+  data?: any;
+}
+/**
+ * Connection metadata attached to each WebSocket
+ */
+interface ConnectionMeta {
+  userId: string;
+  clientId: string;
+  channels: string[];
+}
+/**
+ * Unified message type for both directions
+ */
+type VeraniMessage = ClientMessage | ServerMessage;
+/**
+ * Protocol version for future compatibility
+ */
+declare const PROTOCOL_VERSION = "1.0.0";
+//#endregion
+//#region src/shared/encode.d.ts
+/**
+ * Encodes a message frame to JSON string for transmission
+ * @param frame - The message frame to encode
+ * @returns JSON string representation of the frame
+ * @throws Error if encoding fails
+ */
+declare function encodeFrame(frame: MessageFrame): string;
+/**
+ * Encodes a client message to JSON string
+ * @param message - The client message to encode
+ * @returns JSON string representation
+ */
+declare function encodeClientMessage(message: MessageFrame): string;
+/**
+ * Encodes a server message to JSON string
+ * @param message - The server message to encode
+ * @returns JSON string representation
+ */
+declare function encodeServerMessage(message: MessageFrame): string;
+//#endregion
+//#region src/shared/decode.d.ts
+/**
+ * Decodes a raw message into a MessageFrame
+ * @param raw - Raw data from WebSocket (string, ArrayBuffer, etc)
+ * @returns Decoded MessageFrame or null if invalid
+ */
+declare function decodeFrame(raw: any): MessageFrame | null;
+/**
+ * Decodes a client message
+ * @param raw - Raw data from client WebSocket
+ * @returns Decoded message or null if invalid
+ */
+declare function decodeClientMessage(raw: any): MessageFrame | null;
+/**
+ * Decodes a server message
+ * @param raw - Raw data from server WebSocket
+ * @returns Decoded message or null if invalid
+ */
+declare function decodeServerMessage(raw: any): MessageFrame | null;
+//#endregion
+export { encodeFrame as a, ConnectionMeta as c, ServerMessage as d, VeraniMessage as f, encodeClientMessage as i, MessageFrame as l, decodeFrame as n, encodeServerMessage as o, decodeServerMessage as r, ClientMessage as s, decodeClientMessage as t, PROTOCOL_VERSION as u };

package/dist/decode-DMA_rBWB.d.cts

@@ -0,0 +1,87 @@
+//#region src/shared/types.d.ts
+/**
+ * Core message types shared between client and server
+ */
+/**
+ * Base message frame structure used for all WebSocket communication
+ */
+interface MessageFrame {
+  type: string;
+  channel?: string;
+  data?: any;
+}
+/**
+ * Message sent from client to server
+ */
+interface ClientMessage extends MessageFrame {
+  type: string;
+  channel?: string;
+  data?: any;
+}
+/**
+ * Message sent from server to client
+ */
+interface ServerMessage extends MessageFrame {
+  type: string;
+  channel?: string;
+  data?: any;
+}
+/**
+ * Connection metadata attached to each WebSocket
+ */
+interface ConnectionMeta {
+  userId: string;
+  clientId: string;
+  channels: string[];
+}
+/**
+ * Unified message type for both directions
+ */
+type VeraniMessage = ClientMessage | ServerMessage;
+/**
+ * Protocol version for future compatibility
+ */
+declare const PROTOCOL_VERSION = "1.0.0";
+//#endregion
+//#region src/shared/encode.d.ts
+/**
+ * Encodes a message frame to JSON string for transmission
+ * @param frame - The message frame to encode
+ * @returns JSON string representation of the frame
+ * @throws Error if encoding fails
+ */
+declare function encodeFrame(frame: MessageFrame): string;
+/**
+ * Encodes a client message to JSON string
+ * @param message - The client message to encode
+ * @returns JSON string representation
+ */
+declare function encodeClientMessage(message: MessageFrame): string;
+/**
+ * Encodes a server message to JSON string
+ * @param message - The server message to encode
+ * @returns JSON string representation
+ */
+declare function encodeServerMessage(message: MessageFrame): string;
+//#endregion
+//#region src/shared/decode.d.ts
+/**
+ * Decodes a raw message into a MessageFrame
+ * @param raw - Raw data from WebSocket (string, ArrayBuffer, etc)
+ * @returns Decoded MessageFrame or null if invalid
+ */
+declare function decodeFrame(raw: any): MessageFrame | null;
+/**
+ * Decodes a client message
+ * @param raw - Raw data from client WebSocket
+ * @returns Decoded message or null if invalid
+ */
+declare function decodeClientMessage(raw: any): MessageFrame | null;
+/**
+ * Decodes a server message
+ * @param raw - Raw data from server WebSocket
+ * @returns Decoded message or null if invalid
+ */
+declare function decodeServerMessage(raw: any): MessageFrame | null;
+//#endregion
+export { encodeFrame as a, ConnectionMeta as c, ServerMessage as d, VeraniMessage as f, encodeClientMessage as i, MessageFrame as l, decodeFrame as n, encodeServerMessage as o, decodeServerMessage as r, ClientMessage as s, decodeClientMessage as t, PROTOCOL_VERSION as u };

package/dist/types-083oWz55.cjs

@@ -0,0 +1 @@
+function isValidFrame(e){return e&&typeof e==`object`&&typeof e.type==`string`&&(e.channel===void 0||typeof e.channel==`string`)}function decodeFrame(a){try{let o=typeof a==`string`?a:a.toString(),s=JSON.parse(o);return isValidFrame(s)?s:null}catch{return null}}function decodeClientMessage(e){return decodeFrame(e)}function decodeServerMessage(e){return decodeFrame(e)}function encodeFrame(e){try{return JSON.stringify(e)}catch(e){throw Error(`Failed to encode frame: ${e instanceof Error?e.message:`unknown error`}`)}}function encodeClientMessage(e){return encodeFrame(e)}function encodeServerMessage(e){return encodeFrame(e)}const PROTOCOL_VERSION=`1.0.0`;Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return decodeClientMessage}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return encodeServerMessage}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return encodeClientMessage}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return decodeFrame}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return encodeFrame}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return decodeServerMessage}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return`1.0.0`}});

package/dist/types-CJLnZrA8.mjs

@@ -0,0 +1 @@
+function isValidFrame(e){return e&&typeof e==`object`&&typeof e.type==`string`&&(e.channel===void 0||typeof e.channel==`string`)}function decodeFrame(a){try{let o=typeof a==`string`?a:a.toString(),s=JSON.parse(o);return isValidFrame(s)?s:null}catch{return null}}function decodeClientMessage(e){return decodeFrame(e)}function decodeServerMessage(e){return decodeFrame(e)}function encodeFrame(e){try{return JSON.stringify(e)}catch(e){throw Error(`Failed to encode frame: ${e instanceof Error?e.message:`unknown error`}`)}}function encodeClientMessage(e){return encodeFrame(e)}function encodeServerMessage(e){return encodeFrame(e)}const PROTOCOL_VERSION=`1.0.0`;export{decodeClientMessage as a,encodeServerMessage as i,encodeClientMessage as n,decodeFrame as o,encodeFrame as r,decodeServerMessage as s,PROTOCOL_VERSION as t};