@gravito/ripple 3.0.0 → 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.0",
+  "version": "3.1.0",
   "description": "Bun-native WebSocket broadcasting for Gravito. Channel-based real-time communication.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -21,8 +21,9 @@
     "build": "bun run build.ts",
     "test": "bun test",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
-    "test:coverage": "bun test --coverage --coverage-threshold=80",
-    "test:ci": "bun test --coverage --coverage-threshold=80"
+    "test:coverage": "bun test --coverage --coverage-threshold=60",
+    "test:ci": "bun test --coverage --coverage-threshold=60",
+    "bench": "bun run benchmarks/index.ts"
   },
   "keywords": [
     "gravito",
@@ -41,13 +42,21 @@
   },
   "homepage": "https://github.com/gravito-framework/gravito#readme",
   "peerDependencies": {
-    "@gravito/core": "workspace:*"
+    "@gravito/core": "workspace:*",
+    "ioredis": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "bun-types": "latest",
+    "ioredis": "^5.4.2",
+    "tinybench": "^6.0.0",
     "typescript": "^5.9.3"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/dist/OrbitRipple.d.ts

@@ -1,80 +0,0 @@
-/**
- * @fileoverview OrbitRipple - Gravito module wrapper for Ripple WebSocket
- *
- * Integrates RippleServer with Gravito's PlanetCore.
- *
- * @module @gravito/ripple
- */
-import { RippleServer } from './RippleServer';
-import type { RippleConfig } from './types';
-/**
- * PlanetCore interface for type safety without importing
- */
-interface PlanetCore {
-    logger: {
-        info: (msg: string) => void;
-    };
-    adapter: {
-        use: (path: string, handler: (ctx: any, next: () => Promise<Response | undefined>) => Promise<any>) => void;
-    };
-    hooks: {
-        addAction: (hook: string, callback: (args: unknown) => Promise<void>) => void;
-    };
-}
-/**
- * OrbitRipple - Gravito module for real-time WebSocket communication
- *
- * @example
- * ```typescript
- * import { OrbitRipple } from '@gravito/ripple'
- *
- * const core = new PlanetCore()
- *
- * core.install(new OrbitRipple({
- *   path: '/ws',
- *   authorizer: async (channel, userId, socketId) => {
- *     // Return true for authorized, false for denied
- *     // For presence channels, return { id: userId, info: { name: '...' } }
- *     return true
- *   }
- * }))
- *
- * // The WebSocket is automatically integrated with Bun.serve
- * core.boot()
- * ```
- */
-export declare class OrbitRipple {
-    private server;
-    private config;
-    constructor(config?: RippleConfig);
-    /**
-     * Install the module into PlanetCore
-     */
-    install(core: PlanetCore): void;
-    /**
-     * Get the underlying RippleServer instance
-     */
-    getServer(): RippleServer;
-    /**
-     * Get WebSocket handler for Bun.serve integration
-     *
-     * @example
-     * ```typescript
-     * const ripple = new OrbitRipple()
-     *
-     * Bun.serve({
-     *   fetch: (req, server) => {
-     *     // Let Ripple handle WebSocket upgrades
-     *     if (ripple.getServer().upgrade(req, server)) return
-     *
-     *     // Regular HTTP handling
-     *     return core.adapter.fetch(req, server)
-     *   },
-     *   websocket: ripple.getHandler()
-     * })
-     * ```
-     */
-    getHandler(): import("./types").WebSocketHandlerConfig;
-}
-export {};
-//# sourceMappingURL=OrbitRipple.d.ts.map

package/dist/OrbitRipple.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OrbitRipple.d.ts","sourceRoot":"","sources":["../src/OrbitRipple.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;GAEG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;IACvC,OAAO,EAAE;QACP,GAAG,EAAE,CACH,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,KAC3E,IAAI,CAAA;KACV,CAAA;IACD,KAAK,EAAE;QACL,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;KAC9E,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,GAAE,YAAiB;IAKrC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAuB/B;;OAEG;IACH,SAAS,IAAI,YAAY;IAIzB;;;;;;;;;;;;;;;;;;OAkBG;IACH,UAAU;CAGX"}

package/dist/RippleServer.d.ts

@@ -1,126 +0,0 @@
-/**
- * @fileoverview Ripple WebSocket Server
- *
- * Core WebSocket server implementation using Bun's native WebSocket API.
- *
- * @module @gravito/ripple
- */
-import type { Server } from 'bun';
-import type { ClientData, RippleConfig, RippleWebSocket, WebSocketHandlerConfig } from './types';
-/**
- * Ripple WebSocket Server
- *
- * Provides channel-based real-time communication using Bun's native WebSocket.
- *
- * @example
- * ```typescript
- * const ripple = new RippleServer({
- *   path: '/ws',
- *   authorizer: async (channel, userId) => {
- *     // Custom authorization logic
- *     return true
- *   }
- * })
- *
- * Bun.serve({
- *   fetch: (req, server) => {
- *     if (ripple.upgrade(req, server)) return
- *     return new Response('Not found', { status: 404 })
- *   },
- *   websocket: ripple.getHandler()
- * })
- * ```
- */
-export declare class RippleServer {
-    private channels;
-    private driver;
-    private authorizer?;
-    private pingInterval?;
-    private eventListeners;
-    readonly config: Required<Pick<RippleConfig, 'path' | 'authEndpoint' | 'pingInterval'>> & RippleConfig;
-    constructor(config?: RippleConfig);
-    /**
-     * Register an event listener for client messages.
-     *
-     * @param event - The event name to listen for.
-     * @param handler - The callback function.
-     */
-    on(event: string, handler: (socket: RippleWebSocket, data: any) => void): void;
-    /**
-     * Fluent API for broadcasting to a channel.
-     *
-     * @param channel - The channel name.
-     */
-    to(channel: string): {
-        emit: (event: string, data: unknown) => void;
-    };
-    /**
-     * Attempt to upgrade an HTTP request to WebSocket.
-     *
-     * @param req - The HTTP request.
-     * @param server - The Bun server instance.
-     * @returns True if the request was upgraded, false otherwise.
-     */
-    upgrade(req: Request, server: Server<ClientData>): boolean;
-    /**
-     * Get WebSocket handler configuration for Bun.serve.
-     *
-     * @returns An object containing the WebSocket event handlers.
-     */
-    getHandler(): WebSocketHandlerConfig;
-    private handleOpen;
-    private handleMessage;
-    private handleClose;
-    private handleDrain;
-    private handleSubscribe;
-    private handleUnsubscribe;
-    private handleWhisper;
-    /**
-     * Broadcast an event to a channel.
-     *
-     * @param channel - The channel name.
-     * @param event - The event name.
-     * @param data - The event data.
-     */
-    broadcast(channel: string, event: string, data: unknown): void;
-    /**
-     * Broadcast to specific client IDs.
-     *
-     * @param clientIds - An array of client IDs.
-     * @param event - The event name.
-     * @param data - The event data.
-     */
-    broadcastToClients(clientIds: string[], event: string, data: unknown): void;
-    private broadcastToChannel;
-    private send;
-    /**
-     * Get server statistics.
-     *
-     * @returns An object containing connection and channel statistics.
-     */
-    getStats(): {
-        totalClients: number;
-        totalChannels: number;
-        channels: {
-            name: string;
-            subscribers: number;
-        }[];
-    };
-    /**
-     * Initialize the server.
-     *
-     * Initializes the driver and starts the ping interval.
-     *
-     * @returns A promise that resolves when initialization is complete.
-     */
-    init(): Promise<void>;
-    /**
-     * Shutdown the server.
-     *
-     * Clears the ping interval and shuts down the driver.
-     *
-     * @returns A promise that resolves when shutdown is complete.
-     */
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=RippleServer.d.ts.map

package/dist/RippleServer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RippleServer.d.ts","sourceRoot":"","sources":["../src/RippleServer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAGjC,OAAO,KAAK,EAEV,UAAU,EAEV,YAAY,EAEZ,eAAe,EAEf,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAgC;IACrD,OAAO,CAAC,cAAc,CAA2E;IAEjG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,CAAC,CAAC,GACrF,YAAY,CAAA;gBAEF,MAAM,GAAE,YAAiB;IAarC;;;;;OAKG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAO9E;;;;OAIG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM;sBAEA,MAAM,QAAQ,OAAO;;IAQvC;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO;IAiB1D;;;;OAIG;IACH,UAAU,IAAI,sBAAsB;IAapC,OAAO,CAAC,UAAU;YAUJ,aAAa;IA6B3B,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,WAAW;YASL,eAAe;IA2D7B,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,aAAa;IA0BrB;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAc3E,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,IAAI;IAQZ;;;;OAIG;IACH,QAAQ;;;;;;;;IAIR;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC"}

package/dist/channels/Channel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../src/channels/Channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAMpD,eAAO,MAAM,gBAAgB;;;CAGnB,CAAA;AAMV;;GAEG;AACH,uBAAe,WAAY,YAAW,OAAO;aAGf,IAAI,EAAE,MAAM;IAFxC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;gBAEP,IAAI,EAAE,MAAM;IAExC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAA;IAE/B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAgBnE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAM/C;AAMD;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IAEjC,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF;AAMD;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAS;IAElC,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF;AAMD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;IAEnC,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWvD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,iCAA2B,CAAA"}

package/dist/channels/ChannelManager.d.ts

@@ -1,79 +0,0 @@
-/**
- * @fileoverview Channel Manager for @gravito/ripple
- *
- * Manages channel subscriptions and member tracking.
- *
- * @module @gravito/ripple/channels
- */
-import type { PresenceUserInfo, RippleWebSocket } from '../types';
-/**
- * Manages all channel subscriptions and presence tracking
- */
-export declare class ChannelManager {
-    /** Map of channel name -> Set of client IDs */
-    private subscriptions;
-    /** Map of client ID -> WebSocket */
-    private clients;
-    /** Map of presence channel -> Map of user ID -> user info */
-    private presenceMembers;
-    /**
-     * Register a new client connection
-     */
-    addClient(ws: RippleWebSocket): void;
-    /**
-     * Remove a client and all its subscriptions
-     */
-    removeClient(clientId: string): string[];
-    /**
-     * Get a client by ID
-     */
-    getClient(clientId: string): RippleWebSocket | undefined;
-    /**
-     * Get all connected clients
-     */
-    getAllClients(): RippleWebSocket[];
-    /**
-     * Subscribe a client to a channel
-     */
-    subscribe(clientId: string, channel: string, userInfo?: PresenceUserInfo): boolean;
-    /**
-     * Unsubscribe a client from a channel
-     */
-    unsubscribe(clientId: string, channel: string): boolean;
-    /**
-     * Get all subscribers of a channel
-     */
-    getSubscribers(channel: string): RippleWebSocket[];
-    /**
-     * Check if a client is subscribed to a channel
-     */
-    isSubscribed(clientId: string, channel: string): boolean;
-    /**
-     * Add a member to a presence channel
-     */
-    private addPresenceMember;
-    /**
-     * Remove a member from a presence channel
-     */
-    private removePresenceMember;
-    /**
-     * Get all members of a presence channel
-     */
-    getPresenceMembers(channel: string): PresenceUserInfo[];
-    /**
-     * Get member count for a channel
-     */
-    getMemberCount(channel: string): number;
-    /**
-     * Get channel statistics
-     */
-    getStats(): {
-        totalClients: number;
-        totalChannels: number;
-        channels: {
-            name: string;
-            subscribers: number;
-        }[];
-    };
-}
-//# sourceMappingURL=ChannelManager.d.ts.map

package/dist/channels/ChannelManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ChannelManager.d.ts","sourceRoot":"","sources":["../../src/channels/ChannelManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAGjE;;GAEG;AACH,qBAAa,cAAc;IACzB,+CAA+C;IAC/C,OAAO,CAAC,aAAa,CAAiC;IAEtD,oCAAoC;IACpC,OAAO,CAAC,OAAO,CAAqC;IAEpD,6DAA6D;IAC7D,OAAO,CAAC,eAAe,CAA4D;IAMnF;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIpC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAkBxC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIxD;;OAEG;IACH,aAAa,IAAI,eAAe,EAAE;IAQlC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO;IAyBlF;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IA0BvD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;IAWlD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IASxD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAKvD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQvC;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAA;QACpB,aAAa,EAAE,MAAM,CAAA;QACrB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAClD;CAUF"}

package/dist/channels/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA"}

package/dist/drivers/LocalDriver.d.ts

@@ -1,30 +0,0 @@
-/**
- * @fileoverview Local (in-memory) driver for @gravito/ripple
- *
- * Suitable for single-instance deployments. For horizontal scaling,
- * use the Redis driver.
- *
- * @module @gravito/ripple/drivers
- */
-import type { RippleDriver } from '../types';
-/**
- * In-memory driver for single-instance deployments
- *
- * This driver keeps all state in memory and is suitable for:
- * - Development
- * - Single-server deployments
- * - Serverless functions (with caveats)
- *
- * For multi-server deployments, use RedisDriver instead.
- */
-export declare class LocalDriver implements RippleDriver {
-    readonly name = "local";
-    /** Event callbacks per channel */
-    private listeners;
-    publish(channel: string, event: string, data: unknown): Promise<void>;
-    subscribe(channel: string, callback: (event: string, data: unknown) => void): Promise<void>;
-    unsubscribe(channel: string): Promise<void>;
-    init(): Promise<void>;
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=LocalDriver.d.ts.map

package/dist/drivers/LocalDriver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LocalDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/LocalDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C;;;;;;;;;GASG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAU;IAEvB,kCAAkC;IAClC,OAAO,CAAC,SAAS,CAAiE;IAE5E,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASrE,SAAS,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GAC/C,OAAO,CAAC,IAAI,CAAC;IAOV,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/drivers/index.d.ts

@@ -1,2 +0,0 @@
-export * from './LocalDriver';
-//# sourceMappingURL=index.d.ts.map

package/dist/drivers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA"}

package/dist/events/BroadcastEvent.d.ts

@@ -1,52 +0,0 @@
-/**
- * @fileoverview Broadcast Event base class
- *
- * Events that can be broadcast to WebSocket channels.
- *
- * @module @gravito/ripple/events
- */
-import type { Channel } from '../types';
-/**
- * Abstract base class for broadcast events
- *
- * @example
- * ```typescript
- * class OrderShipped extends BroadcastEvent {
- *   constructor(public order: Order) {
- *     super()
- *   }
- *
- *   broadcastOn() {
- *     return new PrivateChannel(`orders.${this.order.userId}`)
- *   }
- *
- *   broadcastAs() {
- *     return 'OrderShipped'
- *   }
- * }
- *
- * // Broadcast
- * broadcast(new OrderShipped(order))
- * ```
- */
-export declare abstract class BroadcastEvent {
-    /**
-     * The channels to broadcast this event on
-     */
-    abstract broadcastOn(): Channel | Channel[];
-    /**
-     * The event name to use when broadcasting
-     * Defaults to the class name
-     */
-    broadcastAs(): string;
-    /**
-     * Socket IDs to exclude from the broadcast
-     */
-    broadcastExcept(): string[];
-    /**
-     * Get the event data payload
-     * Override to customize the broadcast payload
-     */
-    broadcastWith(): Record<string, unknown>;
-}
-//# sourceMappingURL=BroadcastEvent.d.ts.map

package/dist/events/BroadcastEvent.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BroadcastEvent.d.ts","sourceRoot":"","sources":["../../src/events/BroadcastEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,cAAc;IAClC;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO,GAAG,OAAO,EAAE;IAE3C;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;OAGG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQzC"}

package/dist/events/Broadcaster.d.ts

@@ -1,68 +0,0 @@
-/**
- * @fileoverview Broadcaster for sending events to channels
- *
- * @module @gravito/ripple/events
- */
-import type { RippleServer } from '../RippleServer';
-import type { BroadcastEvent } from './BroadcastEvent';
-/**
- * Set the global Ripple server instance
- */
-export declare function setRippleServer(server: RippleServer): void;
-/**
- * Get the global Ripple server instance
- */
-export declare function getRippleServer(): RippleServer | null;
-/**
- * Broadcast an event to its channels
- *
- * @example
- * ```typescript
- * class OrderShipped extends BroadcastEvent {
- *   constructor(public order: Order) { super() }
- *   broadcastOn() { return new PrivateChannel(`orders.${this.order.userId}`) }
- * }
- *
- * broadcast(new OrderShipped(order))
- * ```
- */
-export declare function broadcast(event: BroadcastEvent): void;
-/**
- * Fluent Broadcaster API for more control
- *
- * @example
- * ```typescript
- * Broadcaster.to('orders.123')
- *   .emit('OrderUpdated', { status: 'shipped' })
- *
- * Broadcaster.toPrivate('orders.123')
- *   .except(socketId)
- *   .emit('OrderUpdated', { status: 'shipped' })
- * ```
- */
-export declare class Broadcaster {
-    private _channel;
-    private _except;
-    private constructor();
-    /**
-     * Target a public channel
-     */
-    static to(channel: string): Broadcaster;
-    /**
-     * Target a private channel
-     */
-    static toPrivate(channel: string): Broadcaster;
-    /**
-     * Target a presence channel
-     */
-    static toPresence(channel: string): Broadcaster;
-    /**
-     * Exclude specific socket IDs from broadcast
-     */
-    except(socketIds: string | string[]): this;
-    /**
-     * Emit an event to the channel
-     */
-    emit(event: string, data: unknown): void;
-}
-//# sourceMappingURL=Broadcaster.d.ts.map

package/dist/events/Broadcaster.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Broadcaster.d.ts","sourceRoot":"","sources":["../../src/events/Broadcaster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAOtD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAiBrD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAe;IAE9B,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAIvC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAI9C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW;IAI/C;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAM1C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;CAQzC"}

package/dist/events/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA"}

package/dist/index.d.ts

@@ -1,38 +0,0 @@
-/**
- * @fileoverview @gravito/ripple - Bun-native WebSocket broadcasting
- *
- * Channel-based real-time communication for Gravito applications.
- *
- * @example
- * ```typescript
- * import { OrbitRipple, broadcast, PrivateChannel, BroadcastEvent } from '@gravito/ripple'
- *
- * // Install the module
- * core.install(new OrbitRipple({
- *   path: '/ws',
- *   authorizer: async (channel, userId) => userId !== undefined
- * }))
- *
- * // Define a broadcast event
- * class OrderShipped extends BroadcastEvent {
- *   constructor(public order: Order) { super() }
- *   broadcastOn() { return new PrivateChannel(`orders.${this.order.userId}`) }
- * }
- *
- * // Broadcast from anywhere
- * broadcast(new OrderShipped(order))
- *
- * // Or use the fluent API
- * import { Broadcaster } from '@gravito/ripple'
- * Broadcaster.toPrivate('orders.123').emit('OrderUpdated', { status: 'shipped' })
- * ```
- *
- * @module @gravito/ripple
- */
-export { CHANNEL_PREFIXES, ChannelManager, createChannel, PresenceChannel, PrivateChannel, PublicChannel, requiresAuth, } from './channels';
-export { LocalDriver } from './drivers';
-export { BroadcastEvent, Broadcaster, broadcast, getRippleServer, setRippleServer } from './events';
-export { OrbitRipple } from './OrbitRipple';
-export { RippleServer } from './RippleServer';
-export type { BroadcastEventInterface, Channel, ChannelAuthorizer, ChannelType, ClientData, ClientMessage, PresenceUserInfo, RippleBunServer, RippleConfig, RippleDriver, RippleWebSocket, ServerMessage, WebSocketHandlerConfig, } from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAEnG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG7C,YAAY,EACV,uBAAuB,EACvB,OAAO,EACP,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,sBAAsB,GACvB,MAAM,SAAS,CAAA"}