@gravito/ripple 3.0.1 → 3.1.0

package/dist/ripple/src/utils/MessageSerializer.d.ts

@@ -0,0 +1,44 @@
+import type { ServerMessage } from '../types';
+/**
+ * Utility class for serializing server-to-client messages.
+ *
+ * Provides performance optimizations like pre-serialized common messages
+ * and a per-broadcast cache to reduce JSON.stringify overhead during
+ * multi-channel broadcasting.
+ */
+export declare class MessageSerializer {
+    /** Pre-serialized pong message for heartbeat responses */
+    private static readonly PONG_MESSAGE;
+    /** Cached serialized string for the current broadcast operation */
+    private broadcastCache;
+    /**
+     * Get the pre-serialized pong message.
+     *
+     * @returns Serialized {"type":"pong"} string
+     */
+    getPongMessage(): string;
+    /**
+     * Serialize a server message to a JSON string.
+     *
+     * @param message - The server message object to serialize
+     * @returns Serialized JSON string
+     */
+    serialize(message: ServerMessage): string;
+    /**
+     * Serialize a message for broadcasting, with internal caching.
+     *
+     * If a broadcast cache already exists, it is returned immediately.
+     * Otherwise, the message is serialized and stored in the cache.
+     *
+     * @param message - The server message to serialize and cache
+     * @returns Serialized JSON string
+     */
+    serializeForBroadcast(message: ServerMessage): string;
+    /**
+     * Clear the current broadcast cache.
+     *
+     * Should be called after a broadcast operation is complete to prepare
+     * for the next broadcast.
+     */
+    clearBroadcastCache(): void;
+}

package/dist/ripple/src/utils/index.d.ts

@@ -0,0 +1 @@
+export { MessageSerializer } from './MessageSerializer';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/ripple",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Bun-native WebSocket broadcasting for Gravito. Channel-based real-time communication.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,8 @@
     "test": "bun test",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
     "test:coverage": "bun test --coverage --coverage-threshold=60",
-    "test:ci": "bun test --coverage --coverage-threshold=60"
+    "test:ci": "bun test --coverage --coverage-threshold=60",
+    "bench": "bun run benchmarks/index.ts"
   },
   "keywords": [
     "gravito",
@@ -52,9 +53,10 @@
   "devDependencies": {
     "bun-types": "latest",
     "ioredis": "^5.4.2",
+    "tinybench": "^6.0.0",
     "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}