verani 0.5.3 → 0.5.4

package/dist/verani.d.cts

@@ -24,6 +24,80 @@ interface RpcBroadcastOptions {
   /** Only send to specific client IDs */
   clientIds?: string[];
 }
+/**
+ * Actor stub interface returned by .get() method.
+ * Provides RPC access to actor methods that can be called remotely.
+ *
+ * Note: RPC methods return Promises even if the underlying method is synchronous.
+ * Methods that return non-serializable types (like WebSocket[] or DurableObjectStorage)
+ * are excluded from this interface.
+ */
+interface ActorStub {
+  /**
+   * Standard fetch method for handling HTTP requests and WebSocket upgrades
+   */
+  fetch(request: Request): Promise<Response>;
+  /**
+   * Socket.IO-like emit API: Emit an event to a specific channel via RPC.
+   * @param channel - Channel name to emit to
+   * @param event - Event name
+   * @param data - Event data
+   * @returns Promise resolving to the number of connections that received the message
+   * @example
+   * ```typescript
+   * await stub.emitToChannel("default", "announcement", { text: "Hello!" });
+   * ```
+   */
+  emitToChannel(channel: string, event: string, data?: any): Promise<number>;
+  /**
+   * Socket.IO-like emit API: Emit an event to a specific user (all their sessions) via RPC.
+   * @param userId - User ID to emit to
+   * @param event - Event name
+   * @param data - Event data
+   * @returns Promise resolving to the number of sessions that received the message
+   * @example
+   * ```typescript
+   * await stub.emitToUser("alice", "notification", { message: "Hello!" });
+   * ```
+   */
+  emitToUser(userId: string, event: string, data?: any): Promise<number>;
+  /**
+   * @deprecated Use `emitToUser()` instead for Socket.IO-like API.
+   * Sends a message to a specific user (all their sessions) via RPC.
+   * @param userId - The user ID to send to
+   * @param channel - The channel to send to
+   * @param data - Message data
+   * @returns Promise resolving to the number of sessions that received the message
+   */
+  sendToUser(userId: string, channel: string, data?: any): Promise<number>;
+  /**
+   * @deprecated Use `emitToChannel()` instead for Socket.IO-like API.
+   * Broadcasts a message to all connections in a channel via RPC.
+   * Note: The `except` option from BroadcastOptions is not available over RPC
+   * since WebSocket cannot be serialized.
+   * @param channel - The channel to broadcast to
+   * @param data - The data to send
+   * @param opts - Broadcast options (filtering by userIds or clientIds)
+   * @returns Promise resolving to the number of connections that received the message
+   */
+  broadcast(channel: string, data: any, opts?: RpcBroadcastOptions): Promise<number>;
+  /**
+   * Gets the total number of active sessions via RPC.
+   * @returns Promise resolving to the number of connected WebSockets
+   */
+  getSessionCount(): Promise<number>;
+  /**
+   * Gets all unique user IDs currently connected via RPC.
+   * @returns Promise resolving to an array of unique user IDs
+   */
+  getConnectedUserIds(): Promise<string[]>;
+  /**
+   * Removes all WebSocket sessions that are not in OPEN state via RPC.
+   * This prevents stale connections from accumulating in memory.
+   * @returns Promise resolving to the number of sessions cleaned up
+   */
+  cleanupStaleSessions(): Promise<number>;
+}
 /**
  * Extended Actor interface with Verani-specific methods
  */
@@ -278,80 +352,6 @@ interface RoomDefinitionWithHandlers<TMeta extends ConnectionMeta = ConnectionMe
 declare function defineRoom<TMeta extends ConnectionMeta = ConnectionMeta, E = unknown>(def: RoomDefinition<TMeta, E>): RoomDefinitionWithHandlers<TMeta, E>;
 //#endregion
 //#region src/actor/actor-runtime.d.ts
-/**
- * Actor stub interface returned by .get() method.
- * Provides RPC access to actor methods that can be called remotely.
- *
- * Note: RPC methods return Promises even if the underlying method is synchronous.
- * Methods that return non-serializable types (like WebSocket[] or DurableObjectStorage)
- * are excluded from this interface.
- */
-interface ActorStub {
-  /**
-   * Standard fetch method for handling HTTP requests and WebSocket upgrades
-   */
-  fetch(request: Request): Promise<Response>;
-  /**
-   * Socket.IO-like emit API: Emit an event to a specific channel via RPC.
-   * @param channel - Channel name to emit to
-   * @param event - Event name
-   * @param data - Event data
-   * @returns Promise resolving to the number of connections that received the message
-   * @example
-   * ```typescript
-   * await stub.emitToChannel("default", "announcement", { text: "Hello!" });
-   * ```
-   */
-  emitToChannel(channel: string, event: string, data?: any): Promise<number>;
-  /**
-   * Socket.IO-like emit API: Emit an event to a specific user (all their sessions) via RPC.
-   * @param userId - User ID to emit to
-   * @param event - Event name
-   * @param data - Event data
-   * @returns Promise resolving to the number of sessions that received the message
-   * @example
-   * ```typescript
-   * await stub.emitToUser("alice", "notification", { message: "Hello!" });
-   * ```
-   */
-  emitToUser(userId: string, event: string, data?: any): Promise<number>;
-  /**
-   * @deprecated Use `emitToUser()` instead for Socket.IO-like API.
-   * Sends a message to a specific user (all their sessions) via RPC.
-   * @param userId - The user ID to send to
-   * @param channel - The channel to send to
-   * @param data - Message data
-   * @returns Promise resolving to the number of sessions that received the message
-   */
-  sendToUser(userId: string, channel: string, data?: any): Promise<number>;
-  /**
-   * @deprecated Use `emitToChannel()` instead for Socket.IO-like API.
-   * Broadcasts a message to all connections in a channel via RPC.
-   * Note: The `except` option from BroadcastOptions is not available over RPC
-   * since WebSocket cannot be serialized.
-   * @param channel - The channel to broadcast to
-   * @param data - The data to send
-   * @param opts - Broadcast options (filtering by userIds or clientIds)
-   * @returns Promise resolving to the number of connections that received the message
-   */
-  broadcast(channel: string, data: any, opts?: RpcBroadcastOptions): Promise<number>;
-  /**
-   * Gets the total number of active sessions via RPC.
-   * @returns Promise resolving to the number of connected WebSockets
-   */
-  getSessionCount(): Promise<number>;
-  /**
-   * Gets all unique user IDs currently connected via RPC.
-   * @returns Promise resolving to an array of unique user IDs
-   */
-  getConnectedUserIds(): Promise<string[]>;
-  /**
-   * Removes all WebSocket sessions that are not in OPEN state via RPC.
-   * This prevents stale connections from accumulating in memory.
-   * @returns Promise resolving to the number of sessions cleaned up
-   */
-  cleanupStaleSessions(): Promise<number>;
-}
 /**
  * Return type for createActorHandler - represents an Actor class constructor
  */

package/dist/verani.d.mts

@@ -24,6 +24,80 @@ interface RpcBroadcastOptions {
   /** Only send to specific client IDs */
   clientIds?: string[];
 }
+/**
+ * Actor stub interface returned by .get() method.
+ * Provides RPC access to actor methods that can be called remotely.
+ *
+ * Note: RPC methods return Promises even if the underlying method is synchronous.
+ * Methods that return non-serializable types (like WebSocket[] or DurableObjectStorage)
+ * are excluded from this interface.
+ */
+interface ActorStub {
+  /**
+   * Standard fetch method for handling HTTP requests and WebSocket upgrades
+   */
+  fetch(request: Request): Promise<Response>;
+  /**
+   * Socket.IO-like emit API: Emit an event to a specific channel via RPC.
+   * @param channel - Channel name to emit to
+   * @param event - Event name
+   * @param data - Event data
+   * @returns Promise resolving to the number of connections that received the message
+   * @example
+   * ```typescript
+   * await stub.emitToChannel("default", "announcement", { text: "Hello!" });
+   * ```
+   */
+  emitToChannel(channel: string, event: string, data?: any): Promise<number>;
+  /**
+   * Socket.IO-like emit API: Emit an event to a specific user (all their sessions) via RPC.
+   * @param userId - User ID to emit to
+   * @param event - Event name
+   * @param data - Event data
+   * @returns Promise resolving to the number of sessions that received the message
+   * @example
+   * ```typescript
+   * await stub.emitToUser("alice", "notification", { message: "Hello!" });
+   * ```
+   */
+  emitToUser(userId: string, event: string, data?: any): Promise<number>;
+  /**
+   * @deprecated Use `emitToUser()` instead for Socket.IO-like API.
+   * Sends a message to a specific user (all their sessions) via RPC.
+   * @param userId - The user ID to send to
+   * @param channel - The channel to send to
+   * @param data - Message data
+   * @returns Promise resolving to the number of sessions that received the message
+   */
+  sendToUser(userId: string, channel: string, data?: any): Promise<number>;
+  /**
+   * @deprecated Use `emitToChannel()` instead for Socket.IO-like API.
+   * Broadcasts a message to all connections in a channel via RPC.
+   * Note: The `except` option from BroadcastOptions is not available over RPC
+   * since WebSocket cannot be serialized.
+   * @param channel - The channel to broadcast to
+   * @param data - The data to send
+   * @param opts - Broadcast options (filtering by userIds or clientIds)
+   * @returns Promise resolving to the number of connections that received the message
+   */
+  broadcast(channel: string, data: any, opts?: RpcBroadcastOptions): Promise<number>;
+  /**
+   * Gets the total number of active sessions via RPC.
+   * @returns Promise resolving to the number of connected WebSockets
+   */
+  getSessionCount(): Promise<number>;
+  /**
+   * Gets all unique user IDs currently connected via RPC.
+   * @returns Promise resolving to an array of unique user IDs
+   */
+  getConnectedUserIds(): Promise<string[]>;
+  /**
+   * Removes all WebSocket sessions that are not in OPEN state via RPC.
+   * This prevents stale connections from accumulating in memory.
+   * @returns Promise resolving to the number of sessions cleaned up
+   */
+  cleanupStaleSessions(): Promise<number>;
+}
 /**
  * Extended Actor interface with Verani-specific methods
  */
@@ -278,80 +352,6 @@ interface RoomDefinitionWithHandlers<TMeta extends ConnectionMeta = ConnectionMe
 declare function defineRoom<TMeta extends ConnectionMeta = ConnectionMeta, E = unknown>(def: RoomDefinition<TMeta, E>): RoomDefinitionWithHandlers<TMeta, E>;
 //#endregion
 //#region src/actor/actor-runtime.d.ts
-/**
- * Actor stub interface returned by .get() method.
- * Provides RPC access to actor methods that can be called remotely.
- *
- * Note: RPC methods return Promises even if the underlying method is synchronous.
- * Methods that return non-serializable types (like WebSocket[] or DurableObjectStorage)
- * are excluded from this interface.
- */
-interface ActorStub {
-  /**
-   * Standard fetch method for handling HTTP requests and WebSocket upgrades
-   */
-  fetch(request: Request): Promise<Response>;
-  /**
-   * Socket.IO-like emit API: Emit an event to a specific channel via RPC.
-   * @param channel - Channel name to emit to
-   * @param event - Event name
-   * @param data - Event data
-   * @returns Promise resolving to the number of connections that received the message
-   * @example
-   * ```typescript
-   * await stub.emitToChannel("default", "announcement", { text: "Hello!" });
-   * ```
-   */
-  emitToChannel(channel: string, event: string, data?: any): Promise<number>;
-  /**
-   * Socket.IO-like emit API: Emit an event to a specific user (all their sessions) via RPC.
-   * @param userId - User ID to emit to
-   * @param event - Event name
-   * @param data - Event data
-   * @returns Promise resolving to the number of sessions that received the message
-   * @example
-   * ```typescript
-   * await stub.emitToUser("alice", "notification", { message: "Hello!" });
-   * ```
-   */
-  emitToUser(userId: string, event: string, data?: any): Promise<number>;
-  /**
-   * @deprecated Use `emitToUser()` instead for Socket.IO-like API.
-   * Sends a message to a specific user (all their sessions) via RPC.
-   * @param userId - The user ID to send to
-   * @param channel - The channel to send to
-   * @param data - Message data
-   * @returns Promise resolving to the number of sessions that received the message
-   */
-  sendToUser(userId: string, channel: string, data?: any): Promise<number>;
-  /**
-   * @deprecated Use `emitToChannel()` instead for Socket.IO-like API.
-   * Broadcasts a message to all connections in a channel via RPC.
-   * Note: The `except` option from BroadcastOptions is not available over RPC
-   * since WebSocket cannot be serialized.
-   * @param channel - The channel to broadcast to
-   * @param data - The data to send
-   * @param opts - Broadcast options (filtering by userIds or clientIds)
-   * @returns Promise resolving to the number of connections that received the message
-   */
-  broadcast(channel: string, data: any, opts?: RpcBroadcastOptions): Promise<number>;
-  /**
-   * Gets the total number of active sessions via RPC.
-   * @returns Promise resolving to the number of connected WebSockets
-   */
-  getSessionCount(): Promise<number>;
-  /**
-   * Gets all unique user IDs currently connected via RPC.
-   * @returns Promise resolving to an array of unique user IDs
-   */
-  getConnectedUserIds(): Promise<string[]>;
-  /**
-   * Removes all WebSocket sessions that are not in OPEN state via RPC.
-   * This prevents stale connections from accumulating in memory.
-   * @returns Promise resolving to the number of sessions cleaned up
-   */
-  cleanupStaleSessions(): Promise<number>;
-}
 /**
  * Return type for createActorHandler - represents an Actor class constructor
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "verani",
-	"version": "0.5.3",
+	"version": "0.5.4",
 	"description": "A simple, focused realtime SDK for Cloudflare Actors with Socket.io-like semantics",
 	"license": "ISC",
 	"keywords": [