verani 0.1.6 → 0.1.7

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}setState(e){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.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()}connect(){try{this.connectionManager.setState(`connecting`),this.emitLifecycleEvent(`connecting`),this.ws=new WebSocket(this.url);let e=setTimeout(()=>{this.connectionManager.getState()===`connecting`&&(this.ws?.close(),this.handleConnectionError(Error(`Connection timeout`)))},this.options.connectionTimeout);this.ws.addEventListener(`open`,()=>{clearTimeout(e),this.handleOpen()}),this.ws.addEventListener(`message`,e=>{this.handleMessage(e)}),this.ws.addEventListener(`close`,t=>{clearTimeout(e),this.handleClose(t)}),this.ws.addEventListener(`error`,t=>{clearTimeout(e),this.handleError(t)})}catch(e){this.handleConnectionError(e)}}handleOpen(){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.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.emitLifecycleEvent(`error`,e),this.onErrorCallback?.(e)}handleConnectionError(e){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}waitForConnection(){return this.isConnected()?Promise.resolve():(this.connectionPromise||=new Promise((e,t)=>{this.connectionResolve=e,this.connectionReject=t}),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.disconnect(),this.connect()}disconnect(){this.connectionManager.cancelReconnect(),this.ws&&=(this.ws.close(1e3,`Client disconnect`),void 0)}close(){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,208 @@
+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;
+  /**
+   * 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?;
+  /**
+   * Creates a new Verani client
+   * @param url - WebSocket URL to connect to
+   * @param options - Client configuration options
+   */
+  constructor(url: string, options?: VeraniClientOptions);
+  /**
+   * 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;
+  /**
+   * 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,208 @@
+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;
+  /**
+   * 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?;
+  /**
+   * Creates a new Verani client
+   * @param url - WebSocket URL to connect to
+   * @param options - Client configuration options
+   */
+  constructor(url: string, options?: VeraniClientOptions);
+  /**
+   * 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;
+  /**
+   * 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}setState(e){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.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()}connect(){try{this.connectionManager.setState(`connecting`),this.emitLifecycleEvent(`connecting`),this.ws=new WebSocket(this.url);let e=setTimeout(()=>{this.connectionManager.getState()===`connecting`&&(this.ws?.close(),this.handleConnectionError(Error(`Connection timeout`)))},this.options.connectionTimeout);this.ws.addEventListener(`open`,()=>{clearTimeout(e),this.handleOpen()}),this.ws.addEventListener(`message`,e=>{this.handleMessage(e)}),this.ws.addEventListener(`close`,c=>{clearTimeout(e),this.handleClose(c)}),this.ws.addEventListener(`error`,c=>{clearTimeout(e),this.handleError(c)})}catch(e){this.handleConnectionError(e)}}handleOpen(){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.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.emitLifecycleEvent(`error`,e),this.onErrorCallback?.(e)}handleConnectionError(e){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}waitForConnection(){return this.isConnected()?Promise.resolve():(this.connectionPromise||=new Promise((e,c)=>{this.connectionResolve=e,this.connectionReject=c}),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.disconnect(),this.connect()}disconnect(){this.connectionManager.cancelReconnect(),this.ws&&=(this.ws.close(1e3,`Client disconnect`),void 0)}close(){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};

package/dist/verani.cjs

@@ -1 +1 @@
-let __cloudflare_actors=require(`@cloudflare/actors`);function defaultExtractMeta(e){let _=crypto.randomUUID(),v=crypto.randomUUID(),y=new URL(e.url).searchParams.get(`channels`);return{userId:_,clientId:v,channels:y?y.split(`,`).map(e=>e.trim()).filter(Boolean):[`default`]}}function defineRoom(e){return{name:e.name,websocketPath:e.websocketPath,extractMeta:e.extractMeta||defaultExtractMeta,onConnect:e.onConnect,onDisconnect:e.onDisconnect,onMessage:e.onMessage,onError:e.onError}}function storeAttachment(e,_){e.serializeAttachment(_)}function restoreSessions(e){let _=0;for(let v of e.ctx.getWebSockets()){let y=v.deserializeAttachment();y&&(e.sessions.set(v,{ws:v,meta:y}),_++)}}function isValidFrame(e){return e&&typeof e==`object`&&typeof e.type==`string`&&(e.channel===void 0||typeof e.channel==`string`)}function decodeFrame(e){try{let _=typeof e==`string`?e:e.toString(),v=JSON.parse(_);return isValidFrame(v)?v: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)}function decodeFrame$1(e){return decodeFrame(e)??{type:`invalid`}}function encodeFrame$1(e){return encodeFrame(e)}function sanitizeToClassName(e){return e.replace(/^\/+/,``).split(/[-_\/\s]+/).map(e=>e.replace(/[^a-zA-Z0-9]/g,``)).filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)||`VeraniActor`}function createActorHandler(_){let v=sanitizeToClassName(_.name||_.websocketPath||`VeraniActor`);class x extends __cloudflare_actors.Actor{constructor(...e){super(...e),this.sessions=new Map}static configuration(e){return{locationHint:`me`,sockets:{upgradePath:_.websocketPath,autoResponse:{ping:`ping`,pong:`pong`}}}}async shouldUpgradeWebSocket(e){return!0}async fetch(e){let v=new URL(e.url),y=e.headers.get(`Upgrade`);return v.pathname===_.websocketPath&&y===`websocket`&&await this.shouldUpgradeWebSocket(e)?this.onWebSocketUpgrade(e):this.onRequest(e)}async onInit(){try{restoreSessions(this),_.onHibernationRestore&&this.sessions.size>0&&await _.onHibernationRestore(this)}catch{}}onWebSocketConnect(e,v){try{let b;if(b=_.extractMeta?_.extractMeta(v):{userId:`anonymous`,clientId:crypto.randomUUID(),channels:[`default`]},storeAttachment(e,b),this.sessions.set(e,{ws:e,meta:b}),_.onConnect){let v={actor:this,ws:e,meta:b};_.onConnect(v)}}catch(v){if(_.onError)try{_.onError(v,{actor:this,ws:e,meta:{userId:`unknown`,clientId:`unknown`,channels:[]}})}catch{}e.close(1011,`Internal server error`)}}onWebSocketMessage(e,v){let y;try{let b=decodeFrame$1(v);if(y=this.sessions.get(e),!y)return;if(_.onMessage){let v={actor:this,ws:e,meta:y.meta,frame:b};_.onMessage(v,b)}}catch(v){if(_.onError&&y)try{_.onError(v,{actor:this,ws:e,meta:y.meta})}catch{}}}onWebSocketDisconnect(e){try{let v=this.sessions.get(e);if(this.sessions.delete(e),v&&_.onDisconnect){let y={actor:this,ws:e,meta:v.meta};_.onDisconnect(y)}}catch{}}broadcast(e,_,v){let y=0,b=encodeFrame$1({type:`event`,channel:e,data:_});for(let{ws:_,meta:x}of this.sessions.values())if(x.channels.includes(e)&&!(v?.except&&_===v.except)&&!(v?.userIds&&!v.userIds.includes(x.userId))&&!(v?.clientIds&&!v.clientIds.includes(x.clientId)))try{_.send(b),y++}catch{}return y}getSessionCount(){return this.sessions.size}getConnectedUserIds(){let e=new Set;for(let{meta:_}of this.sessions.values())e.add(_.userId);return Array.from(e)}getUserSessions(e){let _=[];for(let{ws:v,meta:y}of this.sessions.values())y.userId===e&&_.push(v);return _}sendToUser(e,_,v){let y=0,b=encodeFrame$1({type:`event`,channel:_,data:v});for(let{ws:v,meta:x}of this.sessions.values())if(x.userId===e&&x.channels.includes(_))try{v.send(b),y++}catch{}return y}getStorage(){return this.ctx.storage}}return Object.defineProperty(x,`name`,{value:v,writable:!1,configurable:!0}),x}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,_){this.config=e,this.onStateChange=_,this.state=`disconnected`,this.reconnectAttempts=0,this.currentDelay=e.initialDelay}getState(){return this.state}setState(e){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,_={}){this.url=e,this.listeners=new Map,this.messageQueue=[],this.options={reconnection:{enabled:_.reconnection?.enabled??DEFAULT_RECONNECTION_CONFIG.enabled,maxAttempts:_.reconnection?.maxAttempts??DEFAULT_RECONNECTION_CONFIG.maxAttempts,initialDelay:_.reconnection?.initialDelay??DEFAULT_RECONNECTION_CONFIG.initialDelay,maxDelay:_.reconnection?.maxDelay??DEFAULT_RECONNECTION_CONFIG.maxDelay,backoffMultiplier:_.reconnection?.backoffMultiplier??DEFAULT_RECONNECTION_CONFIG.backoffMultiplier},maxQueueSize:_.maxQueueSize??100,connectionTimeout:_.connectionTimeout??1e4},this.connectionManager=new ConnectionManager(this.options.reconnection,e=>{this.onStateChangeCallback?.(e)}),this.connect()}connect(){try{this.connectionManager.setState(`connecting`),this.emitLifecycleEvent(`connecting`),this.ws=new WebSocket(this.url);let e=setTimeout(()=>{this.connectionManager.getState()===`connecting`&&(this.ws?.close(),this.handleConnectionError(Error(`Connection timeout`)))},this.options.connectionTimeout);this.ws.addEventListener(`open`,()=>{clearTimeout(e),this.handleOpen()}),this.ws.addEventListener(`message`,e=>{this.handleMessage(e)}),this.ws.addEventListener(`close`,_=>{clearTimeout(e),this.handleClose(_)}),this.ws.addEventListener(`error`,_=>{clearTimeout(e),this.handleError(_)})}catch(e){this.handleConnectionError(e)}}handleOpen(){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 _=decodeServerMessage$1(e.data);if(!_)return;let v=_.type,y=_.data;_.type===`event`&&_.data&&typeof _.data==`object`&&`type`in _.data&&(v=_.data.type,y=_.data);let b=this.listeners.get(v);if(b)for(let e of b)try{e(y)}catch{}}handleClose(e){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.emitLifecycleEvent(`error`,e),this.onErrorCallback?.(e)}handleConnectionError(e){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,_){let v=this.listeners.get(e);if(v)for(let e of v)try{e(_)}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}waitForConnection(){return this.isConnected()?Promise.resolve():(this.connectionPromise||=new Promise((e,_)=>{this.connectionResolve=e,this.connectionReject=_}),this.connectionPromise)}on(e,_){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(_)}off(e,_){let v=this.listeners.get(e);v&&(v.delete(_),v.size===0&&this.listeners.delete(e))}once(e,_){let v=y=>{this.off(e,v),_(y)};this.on(e,v)}emit(e,_){let v={type:e,data:_};if(this.isConnected())try{this.ws.send(encodeClientMessage$1(v))}catch{this.queueMessage(v)}else this.queueMessage(v)}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.disconnect(),this.connect()}disconnect(){this.connectionManager.cancelReconnect(),this.ws&&=(this.ws.close(1e3,`Client disconnect`),void 0)}close(){this.disconnect(),this.listeners.clear(),this.messageQueue=[],this.connectionManager.destroy()}};const PROTOCOL_VERSION=`1.0.0`;exports.ConnectionManager=ConnectionManager,exports.DEFAULT_RECONNECTION_CONFIG=DEFAULT_RECONNECTION_CONFIG,exports.PROTOCOL_VERSION=`1.0.0`,exports.VeraniClient=VeraniClient,exports.createActorHandler=createActorHandler,exports.decodeClientMessage=decodeClientMessage,exports.decodeFrame=decodeFrame,exports.decodeServerMessage=decodeServerMessage,exports.defineRoom=defineRoom,exports.encodeClientMessage=encodeClientMessage,exports.encodeFrame=encodeFrame,exports.encodeServerMessage=encodeServerMessage,exports.restoreSessions=restoreSessions,exports.storeAttachment=storeAttachment;
+const require_types=require(`./types-083oWz55.cjs`);let __cloudflare_actors=require(`@cloudflare/actors`);function defaultExtractMeta(e){let a=crypto.randomUUID(),o=crypto.randomUUID(),s=new URL(e.url).searchParams.get(`channels`);return{userId:a,clientId:o,channels:s?s.split(`,`).map(e=>e.trim()).filter(Boolean):[`default`]}}function defineRoom(e){return{name:e.name,websocketPath:e.websocketPath,extractMeta:e.extractMeta||defaultExtractMeta,onConnect:e.onConnect,onDisconnect:e.onDisconnect,onMessage:e.onMessage,onError:e.onError}}function storeAttachment(e,a){e.serializeAttachment(a)}function restoreSessions(e){let a=0;for(let o of e.ctx.getWebSockets()){let s=o.deserializeAttachment();s&&(e.sessions.set(o,{ws:o,meta:s}),a++)}}function decodeFrame$1(a){return require_types.o(a)??{type:`invalid`}}function encodeFrame$1(a){return require_types.r(a)}function sanitizeToClassName(e){return e.replace(/^\/+/,``).split(/[-_\/\s]+/).map(e=>e.replace(/[^a-zA-Z0-9]/g,``)).filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)||`VeraniActor`}function createActorHandler(e){let o=sanitizeToClassName(e.name||e.websocketPath||`VeraniActor`);class s extends __cloudflare_actors.Actor{constructor(...e){super(...e),this.sessions=new Map}static configuration(a){return{locationHint:`me`,sockets:{upgradePath:e.websocketPath,autoResponse:{ping:`ping`,pong:`pong`}}}}async shouldUpgradeWebSocket(e){return!0}async fetch(a){let o=new URL(a.url),s=a.headers.get(`Upgrade`);return o.pathname===e.websocketPath&&s===`websocket`&&await this.shouldUpgradeWebSocket(a)?this.onWebSocketUpgrade(a):this.onRequest(a)}async onInit(){try{restoreSessions(this),e.onHibernationRestore&&this.sessions.size>0&&await e.onHibernationRestore(this)}catch{}}onWebSocketConnect(a,o){try{let s;if(s=e.extractMeta?e.extractMeta(o):{userId:`anonymous`,clientId:crypto.randomUUID(),channels:[`default`]},storeAttachment(a,s),this.sessions.set(a,{ws:a,meta:s}),e.onConnect){let o={actor:this,ws:a,meta:s};e.onConnect(o)}}catch(o){if(e.onError)try{e.onError(o,{actor:this,ws:a,meta:{userId:`unknown`,clientId:`unknown`,channels:[]}})}catch{}a.close(1011,`Internal server error`)}}onWebSocketMessage(a,o){let s;try{let c=decodeFrame$1(o);if(s=this.sessions.get(a),!s)return;if(e.onMessage){let o={actor:this,ws:a,meta:s.meta,frame:c};e.onMessage(o,c)}}catch(o){if(e.onError&&s)try{e.onError(o,{actor:this,ws:a,meta:s.meta})}catch{}}}onWebSocketDisconnect(a){try{let o=this.sessions.get(a);if(this.sessions.delete(a),o&&e.onDisconnect){let s={actor:this,ws:a,meta:o.meta};e.onDisconnect(s)}}catch{}}broadcast(e,a,o){let s=0,c=encodeFrame$1({type:`event`,channel:e,data:a});for(let{ws:a,meta:l}of this.sessions.values())if(l.channels.includes(e)&&!(o?.except&&a===o.except)&&!(o?.userIds&&!o.userIds.includes(l.userId))&&!(o?.clientIds&&!o.clientIds.includes(l.clientId)))try{a.send(c),s++}catch{}return s}getSessionCount(){return this.sessions.size}getConnectedUserIds(){let e=new Set;for(let{meta:a}of this.sessions.values())e.add(a.userId);return Array.from(e)}getUserSessions(e){let a=[];for(let{ws:o,meta:s}of this.sessions.values())s.userId===e&&a.push(o);return a}sendToUser(e,a,o){let s=0,c=encodeFrame$1({type:`event`,channel:a,data:o});for(let{ws:o,meta:l}of this.sessions.values())if(l.userId===e&&l.channels.includes(a))try{o.send(c),s++}catch{}return s}getStorage(){return this.ctx.storage}}return Object.defineProperty(s,`name`,{value:o,writable:!1,configurable:!0}),s}exports.PROTOCOL_VERSION=require_types.t,exports.createActorHandler=createActorHandler,exports.decodeClientMessage=require_types.a,exports.decodeFrame=require_types.o,exports.decodeServerMessage=require_types.s,exports.defineRoom=defineRoom,exports.encodeClientMessage=require_types.n,exports.encodeFrame=require_types.r,exports.encodeServerMessage=require_types.i,exports.restoreSessions=restoreSessions,exports.storeAttachment=storeAttachment;

package/dist/verani.d.cts

@@ -1,52 +1,8 @@
+import { a as encodeFrame, c as ConnectionMeta, d as ServerMessage, f as VeraniMessage, i as encodeClientMessage, l as MessageFrame, n as decodeFrame, o as encodeServerMessage, r as decodeServerMessage, s as ClientMessage, t as decodeClientMessage, u as PROTOCOL_VERSION } from "./decode-DMA_rBWB.cjs";
 import { Actor, ActorConfiguration } from "@cloudflare/actors";
 
-//#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/actor/types.d.ts
+
 /**
  * Options for broadcasting messages to connections
  */
@@ -181,250 +137,4 @@ declare function createActorHandler<TMeta extends ConnectionMeta = ConnectionMet
 declare function storeAttachment(ws: WebSocket, meta: ConnectionMeta): void;
 declare function restoreSessions(actor: any): void;
 //#endregion
-//#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;
-  /**
-   * 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?;
-  /**
-   * Creates a new Verani client
-   * @param url - WebSocket URL to connect to
-   * @param options - Client configuration options
-   */
-  constructor(url: string, options?: VeraniClientOptions);
-  /**
-   * 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;
-  /**
-   * 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
-//#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 { type ActorHandlerClass, type ActorStub, type BroadcastOptions, type ClientMessage, ConnectionManager, type ConnectionMeta, type ConnectionState, DEFAULT_RECONNECTION_CONFIG, type MessageContext, type MessageFrame, PROTOCOL_VERSION, type ReconnectionConfig, type RoomContext, type RoomDefinition, type ServerMessage, type VeraniActor, VeraniClient, type VeraniClientOptions, type VeraniMessage, createActorHandler, decodeClientMessage, decodeFrame, decodeServerMessage, defineRoom, encodeClientMessage, encodeFrame, encodeServerMessage, restoreSessions, storeAttachment };
+export { type ActorHandlerClass, type ActorStub, type BroadcastOptions, type ClientMessage, type ConnectionMeta, type MessageContext, type MessageFrame, PROTOCOL_VERSION, type RoomContext, type RoomDefinition, type ServerMessage, type VeraniActor, type VeraniMessage, createActorHandler, decodeClientMessage, decodeFrame, decodeServerMessage, defineRoom, encodeClientMessage, encodeFrame, encodeServerMessage, restoreSessions, storeAttachment };

package/dist/verani.d.mts

@@ -1,52 +1,8 @@
+import { a as encodeFrame, c as ConnectionMeta, d as ServerMessage, f as VeraniMessage, i as encodeClientMessage, l as MessageFrame, n as decodeFrame, o as encodeServerMessage, r as decodeServerMessage, s as ClientMessage, t as decodeClientMessage, u as PROTOCOL_VERSION } from "./decode-9DerwlQ1.mjs";
 import { Actor, ActorConfiguration } from "@cloudflare/actors";
 
-//#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/actor/types.d.ts
+
 /**
  * Options for broadcasting messages to connections
  */
@@ -181,250 +137,4 @@ declare function createActorHandler<TMeta extends ConnectionMeta = ConnectionMet
 declare function storeAttachment(ws: WebSocket, meta: ConnectionMeta): void;
 declare function restoreSessions(actor: any): void;
 //#endregion
-//#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;
-  /**
-   * 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?;
-  /**
-   * Creates a new Verani client
-   * @param url - WebSocket URL to connect to
-   * @param options - Client configuration options
-   */
-  constructor(url: string, options?: VeraniClientOptions);
-  /**
-   * 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;
-  /**
-   * 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
-//#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 { type ActorHandlerClass, type ActorStub, type BroadcastOptions, type ClientMessage, ConnectionManager, type ConnectionMeta, type ConnectionState, DEFAULT_RECONNECTION_CONFIG, type MessageContext, type MessageFrame, PROTOCOL_VERSION, type ReconnectionConfig, type RoomContext, type RoomDefinition, type ServerMessage, type VeraniActor, VeraniClient, type VeraniClientOptions, type VeraniMessage, createActorHandler, decodeClientMessage, decodeFrame, decodeServerMessage, defineRoom, encodeClientMessage, encodeFrame, encodeServerMessage, restoreSessions, storeAttachment };
+export { type ActorHandlerClass, type ActorStub, type BroadcastOptions, type ClientMessage, type ConnectionMeta, type MessageContext, type MessageFrame, PROTOCOL_VERSION, type RoomContext, type RoomDefinition, type ServerMessage, type VeraniActor, type VeraniMessage, createActorHandler, decodeClientMessage, decodeFrame, decodeServerMessage, defineRoom, encodeClientMessage, encodeFrame, encodeServerMessage, restoreSessions, storeAttachment };

package/dist/verani.mjs

@@ -1 +1 @@
-import{Actor}from"@cloudflare/actors";function defaultExtractMeta(e){let _=crypto.randomUUID(),v=crypto.randomUUID(),y=new URL(e.url).searchParams.get(`channels`);return{userId:_,clientId:v,channels:y?y.split(`,`).map(e=>e.trim()).filter(Boolean):[`default`]}}function defineRoom(e){return{name:e.name,websocketPath:e.websocketPath,extractMeta:e.extractMeta||defaultExtractMeta,onConnect:e.onConnect,onDisconnect:e.onDisconnect,onMessage:e.onMessage,onError:e.onError}}function storeAttachment(e,_){e.serializeAttachment(_)}function restoreSessions(e){let _=0;for(let v of e.ctx.getWebSockets()){let y=v.deserializeAttachment();y&&(e.sessions.set(v,{ws:v,meta:y}),_++)}}function isValidFrame(e){return e&&typeof e==`object`&&typeof e.type==`string`&&(e.channel===void 0||typeof e.channel==`string`)}function decodeFrame(e){try{let _=typeof e==`string`?e:e.toString(),v=JSON.parse(_);return isValidFrame(v)?v: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)}function decodeFrame$1(e){return decodeFrame(e)??{type:`invalid`}}function encodeFrame$1(e){return encodeFrame(e)}function sanitizeToClassName(e){return e.replace(/^\/+/,``).split(/[-_\/\s]+/).map(e=>e.replace(/[^a-zA-Z0-9]/g,``)).filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)||`VeraniActor`}function createActorHandler(_){let v=sanitizeToClassName(_.name||_.websocketPath||`VeraniActor`);class x extends Actor{constructor(...e){super(...e),this.sessions=new Map}static configuration(e){return{locationHint:`me`,sockets:{upgradePath:_.websocketPath,autoResponse:{ping:`ping`,pong:`pong`}}}}async shouldUpgradeWebSocket(e){return!0}async fetch(e){let v=new URL(e.url),y=e.headers.get(`Upgrade`);return v.pathname===_.websocketPath&&y===`websocket`&&await this.shouldUpgradeWebSocket(e)?this.onWebSocketUpgrade(e):this.onRequest(e)}async onInit(){try{restoreSessions(this),_.onHibernationRestore&&this.sessions.size>0&&await _.onHibernationRestore(this)}catch{}}onWebSocketConnect(e,v){try{let b;if(b=_.extractMeta?_.extractMeta(v):{userId:`anonymous`,clientId:crypto.randomUUID(),channels:[`default`]},storeAttachment(e,b),this.sessions.set(e,{ws:e,meta:b}),_.onConnect){let v={actor:this,ws:e,meta:b};_.onConnect(v)}}catch(v){if(_.onError)try{_.onError(v,{actor:this,ws:e,meta:{userId:`unknown`,clientId:`unknown`,channels:[]}})}catch{}e.close(1011,`Internal server error`)}}onWebSocketMessage(e,v){let y;try{let b=decodeFrame$1(v);if(y=this.sessions.get(e),!y)return;if(_.onMessage){let v={actor:this,ws:e,meta:y.meta,frame:b};_.onMessage(v,b)}}catch(v){if(_.onError&&y)try{_.onError(v,{actor:this,ws:e,meta:y.meta})}catch{}}}onWebSocketDisconnect(e){try{let v=this.sessions.get(e);if(this.sessions.delete(e),v&&_.onDisconnect){let y={actor:this,ws:e,meta:v.meta};_.onDisconnect(y)}}catch{}}broadcast(e,_,v){let y=0,b=encodeFrame$1({type:`event`,channel:e,data:_});for(let{ws:_,meta:x}of this.sessions.values())if(x.channels.includes(e)&&!(v?.except&&_===v.except)&&!(v?.userIds&&!v.userIds.includes(x.userId))&&!(v?.clientIds&&!v.clientIds.includes(x.clientId)))try{_.send(b),y++}catch{}return y}getSessionCount(){return this.sessions.size}getConnectedUserIds(){let e=new Set;for(let{meta:_}of this.sessions.values())e.add(_.userId);return Array.from(e)}getUserSessions(e){let _=[];for(let{ws:v,meta:y}of this.sessions.values())y.userId===e&&_.push(v);return _}sendToUser(e,_,v){let y=0,b=encodeFrame$1({type:`event`,channel:_,data:v});for(let{ws:v,meta:x}of this.sessions.values())if(x.userId===e&&x.channels.includes(_))try{v.send(b),y++}catch{}return y}getStorage(){return this.ctx.storage}}return Object.defineProperty(x,`name`,{value:v,writable:!1,configurable:!0}),x}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,_){this.config=e,this.onStateChange=_,this.state=`disconnected`,this.reconnectAttempts=0,this.currentDelay=e.initialDelay}getState(){return this.state}setState(e){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,_={}){this.url=e,this.listeners=new Map,this.messageQueue=[],this.options={reconnection:{enabled:_.reconnection?.enabled??DEFAULT_RECONNECTION_CONFIG.enabled,maxAttempts:_.reconnection?.maxAttempts??DEFAULT_RECONNECTION_CONFIG.maxAttempts,initialDelay:_.reconnection?.initialDelay??DEFAULT_RECONNECTION_CONFIG.initialDelay,maxDelay:_.reconnection?.maxDelay??DEFAULT_RECONNECTION_CONFIG.maxDelay,backoffMultiplier:_.reconnection?.backoffMultiplier??DEFAULT_RECONNECTION_CONFIG.backoffMultiplier},maxQueueSize:_.maxQueueSize??100,connectionTimeout:_.connectionTimeout??1e4},this.connectionManager=new ConnectionManager(this.options.reconnection,e=>{this.onStateChangeCallback?.(e)}),this.connect()}connect(){try{this.connectionManager.setState(`connecting`),this.emitLifecycleEvent(`connecting`),this.ws=new WebSocket(this.url);let e=setTimeout(()=>{this.connectionManager.getState()===`connecting`&&(this.ws?.close(),this.handleConnectionError(Error(`Connection timeout`)))},this.options.connectionTimeout);this.ws.addEventListener(`open`,()=>{clearTimeout(e),this.handleOpen()}),this.ws.addEventListener(`message`,e=>{this.handleMessage(e)}),this.ws.addEventListener(`close`,_=>{clearTimeout(e),this.handleClose(_)}),this.ws.addEventListener(`error`,_=>{clearTimeout(e),this.handleError(_)})}catch(e){this.handleConnectionError(e)}}handleOpen(){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 _=decodeServerMessage$1(e.data);if(!_)return;let v=_.type,y=_.data;_.type===`event`&&_.data&&typeof _.data==`object`&&`type`in _.data&&(v=_.data.type,y=_.data);let b=this.listeners.get(v);if(b)for(let e of b)try{e(y)}catch{}}handleClose(e){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.emitLifecycleEvent(`error`,e),this.onErrorCallback?.(e)}handleConnectionError(e){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,_){let v=this.listeners.get(e);if(v)for(let e of v)try{e(_)}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}waitForConnection(){return this.isConnected()?Promise.resolve():(this.connectionPromise||=new Promise((e,_)=>{this.connectionResolve=e,this.connectionReject=_}),this.connectionPromise)}on(e,_){this.listeners.has(e)||this.listeners.set(e,new Set),this.listeners.get(e).add(_)}off(e,_){let v=this.listeners.get(e);v&&(v.delete(_),v.size===0&&this.listeners.delete(e))}once(e,_){let v=y=>{this.off(e,v),_(y)};this.on(e,v)}emit(e,_){let v={type:e,data:_};if(this.isConnected())try{this.ws.send(encodeClientMessage$1(v))}catch{this.queueMessage(v)}else this.queueMessage(v)}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.disconnect(),this.connect()}disconnect(){this.connectionManager.cancelReconnect(),this.ws&&=(this.ws.close(1e3,`Client disconnect`),void 0)}close(){this.disconnect(),this.listeners.clear(),this.messageQueue=[],this.connectionManager.destroy()}};const PROTOCOL_VERSION=`1.0.0`;export{ConnectionManager,DEFAULT_RECONNECTION_CONFIG,PROTOCOL_VERSION,VeraniClient,createActorHandler,decodeClientMessage,decodeFrame,decodeServerMessage,defineRoom,encodeClientMessage,encodeFrame,encodeServerMessage,restoreSessions,storeAttachment};
+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";import{Actor}from"@cloudflare/actors";function defaultExtractMeta(e){let d=crypto.randomUUID(),f=crypto.randomUUID(),p=new URL(e.url).searchParams.get(`channels`);return{userId:d,clientId:f,channels:p?p.split(`,`).map(e=>e.trim()).filter(Boolean):[`default`]}}function defineRoom(e){return{name:e.name,websocketPath:e.websocketPath,extractMeta:e.extractMeta||defaultExtractMeta,onConnect:e.onConnect,onDisconnect:e.onDisconnect,onMessage:e.onMessage,onError:e.onError}}function storeAttachment(e,d){e.serializeAttachment(d)}function restoreSessions(e){let d=0;for(let f of e.ctx.getWebSockets()){let p=f.deserializeAttachment();p&&(e.sessions.set(f,{ws:f,meta:p}),d++)}}function decodeFrame$1(e){return decodeFrame(e)??{type:`invalid`}}function encodeFrame$1(e){return encodeFrame(e)}function sanitizeToClassName(e){return e.replace(/^\/+/,``).split(/[-_\/\s]+/).map(e=>e.replace(/[^a-zA-Z0-9]/g,``)).filter(e=>e.length>0).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join(``)||`VeraniActor`}function createActorHandler(e){let d=sanitizeToClassName(e.name||e.websocketPath||`VeraniActor`);class f extends Actor{constructor(...e){super(...e),this.sessions=new Map}static configuration(d){return{locationHint:`me`,sockets:{upgradePath:e.websocketPath,autoResponse:{ping:`ping`,pong:`pong`}}}}async shouldUpgradeWebSocket(e){return!0}async fetch(d){let f=new URL(d.url),p=d.headers.get(`Upgrade`);return f.pathname===e.websocketPath&&p===`websocket`&&await this.shouldUpgradeWebSocket(d)?this.onWebSocketUpgrade(d):this.onRequest(d)}async onInit(){try{restoreSessions(this),e.onHibernationRestore&&this.sessions.size>0&&await e.onHibernationRestore(this)}catch{}}onWebSocketConnect(d,f){try{let p;if(p=e.extractMeta?e.extractMeta(f):{userId:`anonymous`,clientId:crypto.randomUUID(),channels:[`default`]},storeAttachment(d,p),this.sessions.set(d,{ws:d,meta:p}),e.onConnect){let f={actor:this,ws:d,meta:p};e.onConnect(f)}}catch(f){if(e.onError)try{e.onError(f,{actor:this,ws:d,meta:{userId:`unknown`,clientId:`unknown`,channels:[]}})}catch{}d.close(1011,`Internal server error`)}}onWebSocketMessage(d,f){let p;try{let m=decodeFrame$1(f);if(p=this.sessions.get(d),!p)return;if(e.onMessage){let f={actor:this,ws:d,meta:p.meta,frame:m};e.onMessage(f,m)}}catch(f){if(e.onError&&p)try{e.onError(f,{actor:this,ws:d,meta:p.meta})}catch{}}}onWebSocketDisconnect(d){try{let f=this.sessions.get(d);if(this.sessions.delete(d),f&&e.onDisconnect){let p={actor:this,ws:d,meta:f.meta};e.onDisconnect(p)}}catch{}}broadcast(e,d,f){let p=0,m=encodeFrame$1({type:`event`,channel:e,data:d});for(let{ws:d,meta:h}of this.sessions.values())if(h.channels.includes(e)&&!(f?.except&&d===f.except)&&!(f?.userIds&&!f.userIds.includes(h.userId))&&!(f?.clientIds&&!f.clientIds.includes(h.clientId)))try{d.send(m),p++}catch{}return p}getSessionCount(){return this.sessions.size}getConnectedUserIds(){let e=new Set;for(let{meta:d}of this.sessions.values())e.add(d.userId);return Array.from(e)}getUserSessions(e){let d=[];for(let{ws:f,meta:p}of this.sessions.values())p.userId===e&&d.push(f);return d}sendToUser(e,d,f){let p=0,m=encodeFrame$1({type:`event`,channel:d,data:f});for(let{ws:f,meta:h}of this.sessions.values())if(h.userId===e&&h.channels.includes(d))try{f.send(m),p++}catch{}return p}getStorage(){return this.ctx.storage}}return Object.defineProperty(f,`name`,{value:d,writable:!1,configurable:!0}),f}export{PROTOCOL_VERSION,createActorHandler,decodeClientMessage,decodeFrame,decodeServerMessage,defineRoom,encodeClientMessage,encodeFrame,encodeServerMessage,restoreSessions,storeAttachment};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "verani",
-	"version": "0.1.6",
+	"version": "0.1.7",
 	"description": "A simple, focused realtime SDK for Cloudflare Actors with Socket.io-like semantics",
 	"license": "ISC",
 	"keywords": [
@@ -24,6 +24,16 @@
 				"types": "./dist/verani.d.cts",
 				"default": "./dist/verani.cjs"
 			}
+		},
+		"./client": {
+			"import": {
+				"types": "./dist/client.d.mts",
+				"default": "./dist/client.mjs"
+			},
+			"require": {
+				"types": "./dist/client.d.cts",
+				"default": "./dist/client.cjs"
+			}
 		}
 	},
 	"files": [