room-kit 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,16 @@
+name: Publish
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+      - run: npx jsr publish

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Scott Lott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,262 @@
+# room-kit
+
+[![GitHub Repo stars](https://img.shields.io/github/stars/only-cliches/room-kit)](https://github.com/only-cliches/room-kit)
+[![NPM Version](https://img.shields.io/npm/v/room-kit)](https://www.npmjs.com/package/room-kit)
+[![JSR Version](https://img.shields.io/jsr/v/%40onlycliches/room-kit)](https://jsr.io/@onlycliches/room-kit)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Small and type-safe room membership, presence, and realtime messaging for Socket.IO.
+
+## Install
+
+```bash
+npm install room-kit socket.io socket.io-client
+```
+
+## Quick Start
+
+```ts
+// common.ts
+import { defineRoomType } from "room-kit";
+
+// Shared room schema used by both server and client.
+type ChatMessage = {
+  id: string;
+  name: string;
+  text: string;
+  sentAt: string;
+};
+
+// The generic schema below drives the inferred server and client typing.
+export const chatRoom = defineRoomType<{
+  // Data required from the client to join a room.
+  joinRequest: {
+    roomId: string;
+    roomKey: string;
+    userName: string;
+  };
+  // Per-member metadata stored by the server.
+  memberProfile: {
+    userId: string;
+    userName: string;
+  };
+  // Per-room metadata exposed to every joined client.
+  roomProfile: {
+    roomId: string;
+    created: string;
+  };
+  // Private mutable state that only lives on the server.
+  serverState: {
+    roomKey: string;
+    created: string;
+    history: ChatMessage[];
+  };
+  // Named events the server can emit to room members.
+  events: {
+    message: ChatMessage;
+    systemNotice: { text: string; sentAt: string };
+  };
+  // Typed request/response calls for validated mutations.
+  rpc: {
+    sendMessage: (input: { text: string }): Promise<{ id: string }>;
+  };
+}>({ name: "chat", presence: "list" });
+```
+
+```ts
+// server.ts
+import { randomUUID } from "node:crypto";
+import http from "node:http";
+import { Server } from "socket.io";
+import { ClientSafeError, serveRoomType } from "room-kit";
+import { chatRoom } from "./common";
+
+const httpServer = http.createServer();
+const io = new Server(httpServer);
+
+io.on("connection", (socket) => {
+  // Attach room behavior to each socket connection.
+  serveRoomType<typeof chatRoom, { userId: string }>(socket, chatRoom, {
+    onAuth: async () => {
+      // Replace with real session/JWT validation.
+      // This is your trusted identity source.
+      return { userId: socket.id };
+    },
+    initState: async (join) => ({
+      // Runs once per room instance (first successful join).
+      roomKey: join.roomKey,
+      created: new Date().toISOString(),
+      history: [],
+    }),
+    admit: async (join, ctx) => {
+      // Admission gate for private rooms.
+      // Throw ClientSafeError for messages safe to show users.
+      if (ctx.serverState.roomKey !== join.roomKey) {
+        throw new ClientSafeError("Invalid room key");
+      }
+
+      return {
+        roomId: join.roomId,
+        memberId: ctx.auth.userId,
+        // This profile is returned to the joining member and stored server-side.
+        memberProfile: {
+          userId: ctx.auth.userId,
+          userName: join.userName,
+        },
+        // Room metadata available to all joined members.
+        roomProfile: {
+          roomId: join.roomId,
+          created: ctx.serverState.created,
+        },
+      };
+    },
+    events: {
+      // Client emits are allowlisted by key in this object.
+      // If you don't need client-originated events, omit this.
+      message: async () => undefined,
+    },
+    rpc: {
+      sendMessage: async ({ text }, ctx) => {
+        // Prefer RPC for validated state-changing operations.
+        // Build the canonical message once, then persist and broadcast it.
+        const message = {
+          id: randomUUID(),
+          name: ctx.memberProfile.userName,
+          text,
+          sentAt: new Date().toISOString(),
+        };
+        ctx.serverState.history.push(message);
+        await ctx.emit.message(message);
+        return { id: message.id };
+      },
+    },
+  });
+});
+
+httpServer.listen(3000);
+```
+
+```ts
+// client.ts
+import { io } from "socket.io-client";
+import { createRoomClient } from "room-kit";
+import { chatRoom } from "./common";
+
+// Create the socket transport and bind the typed room client to it.
+const socket = io("http://127.0.0.1:3000");
+const chatClient = createRoomClient(socket, chatRoom);
+
+// Join returns a typed room handle with events, RPC, and leave().
+const joined = await chatClient.join({
+  roomId: "team-alpha",
+  roomKey: "secret",
+  userName: "Ada",
+});
+
+// Event payload and metadata are both inferred from the room schema.
+joined.on.message((payload, meta) => {
+  // meta.source.kind is "server" or "member".
+  console.log(payload.text, meta.source.kind);
+});
+
+// Fully typed request/response based on your room definition.
+await joined.rpc.sendMessage({ text: "hello" });
+// Cleanly leave the room when you're done.
+await joined.leave();
+```
+
+## Room Schema
+
+`defineRoomType<TSchema>(options)` takes a runtime options object. `TSchema` controls the inferred API surface:
+
+- `joinRequest`: payload the client must send to join a room; it must include `roomId`.
+- `memberProfile`: per-member metadata stored by the server and exposed in membership snapshots.
+- `roomProfile`: per-room metadata returned on join and reused in server context; it must include `roomId`.
+- `serverState`: private mutable state owned by the server for each room instance.
+- `events`: named room events the server may emit and, if declared in handlers, accept from clients.
+- `rpc`: named request/response methods exposed to joined clients.
+
+Runtime presence mode is configured in the `defineRoomType` options:
+
+- `"none"`: no presence query support.
+- `"count"`: only count support.
+- `"list"`: count + paginated members.
+- default: `"list"` when `presence` is omitted.
+
+## Server Handlers
+
+`serveRoomType(socket, roomType, handlers, adapter?)` accepts:
+
+- `onAuth(socket)`: optional unless you type a non-`unknown` auth context.
+- `onConnect(socket, auth)`: optional transport-connect hook attempted once when the socket handler is attached (after auth resolution).
+- `revalidateAuth(socket, auth)`: optional per-request auth validation hook; return `{ kind: "ok", auth? }` to continue or `{ kind: "reject" }` to deny.
+- `initState(joinRequest)`: initializes room server state on first join for a given room instance.
+- `admit(joinRequest, ctx)`: required admission gate; returns `roomId`, `memberId`, `memberProfile`, and `roomProfile`.
+- `onJoin(memberProfile, ctx)`: called after a successful join.
+- `onLeave(memberProfile, ctx)`: called on leave and during socket disconnect cleanup for joined rooms when auth is available for cleanup.
+- `onDisconnect(socket, auth)`: optional transport-disconnect hook.
+- `presencePolicy(ctx)`: optional server-side override for presence queries; the returned policy is clamped by the room's configured presence mode.
+- `events`: handlers for client-emitted events. Leave a key out to deny that client event.
+- `rpc`: handlers for client RPC calls.
+
+Server context (`ctx`) includes:
+
+- `ctx.name`, `ctx.roomId`, `ctx.auth`, `ctx.memberId`, `ctx.memberProfile`
+- `ctx.roomProfile`, `ctx.serverState`
+- `ctx.emit.<event>(payload)` to emit to the current room
+- `ctx.broadcast.emit.<event>(payload)` to emit across the namespace
+- `ctx.broadcast.toRoom(roomId).emit.<event>(payload)` to target a room
+- `ctx.broadcast.toMembers(memberIds).emit.<event>(payload)` to target specific members
+- `ctx.getPresence()`, `ctx.getPresenceCount()`, `ctx.listPresenceMembers({ offset, limit })`
+
+`serveRoomType` returns a handle:
+
+- `stop()` unregisters listeners for that socket
+- `stop.rooms()` returns snapshots for all rooms on the namespace
+- `stop.room(roomId)` returns one room snapshot or `undefined`
+- `stop.count(roomId)` returns the current member count for a room (`0` when the room does not exist; throws when room presence mode is `"none"`)
+- `stop.members(roomId, query)` returns a paginated presence listing (`{ count: 0, offset: 0, limit: 0, members: [] }` when the room does not exist; throws when room presence mode is not `"list"`)
+
+## Client API
+
+`createRoomClient(socket, roomType)` returns:
+
+- `client.name`
+- `client.connection.current` (`"connecting" | "connected" | "reconnecting" | "disconnected"`)
+- `client.connection.onChange(handler)` subscribes to transport-state changes and returns an unsubscribe function.
+- `client.join(joinRequest)` resolves to a `joinedRoom` handle.
+
+`joinedRoom` includes:
+
+- `joinedRoom.name`, `joinedRoom.roomId`, `joinedRoom.memberId`, `joinedRoom.roomProfile`
+- `joinedRoom.rpc.<name>(...args)` for typed RPC calls
+- `joinedRoom.emit.<event>(payload)` for client-emitted room events
+- `joinedRoom.on.<event>((payload, meta) => {})` for room event subscriptions
+- `joinedRoom.leave()` to leave the room and unregister the joined-room handle
+- `joinedRoom.presence` is part of the typed API when room presence mode is `"count"` or `"list"`; it exposes `current`, `onChange(handler)`, `count()`, and `list({ offset, limit })` when presence mode is `"list"`.
+
+## Errors and Security
+
+- Throw `ClientSafeError` for messages you want sent to clients.
+- Non-`ClientSafeError` exceptions are sanitized to: `"An internal server error occurred."`
+- RPC and event dispatch only allow own properties (`Object.hasOwn`) to prevent prototype-based handler access.
+- Client event names are default-deny unless explicitly declared in `handlers.events`.
+- Do not trust client payloads for authorization; derive identity in `onAuth`.
+- Validate runtime payload shapes in your handlers. TypeScript types are compile-time only.
+
+## Reconnect Behavior
+
+- Joined rooms are automatically replayed after socket reconnect.
+- Replay uses the original `joinRequest` payload.
+- If replay fails, that joined room is removed from the client registry.
+
+## Example App
+
+A complete chat example is in the `example` directory:
+
+```bash
+cd example
+npm install
+npm start
+```

package/changelog.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 1.0.0
+
+- Initial release of `room-kit`.
+- Typed channel primitives for Socket.IO events, requests, streams, and room membership.
+- Runtime protocol support for event, request/response, stream subscribe/publish, and room join/leave flows.
+- Test coverage for runtime behavior and Socket.IO integration.
+- Added first-class room membership flows with `channel(...).room(...)`.
+- Added reconnect replay for active stream subscriptions and room memberships.
+- Added Socket.IO client and server adapters for room-aware sends and membership mutation.
+- Added a JSR-ready package entrypoint via `jsr.json`.
+- Expanded the README with current client, server, and JSR examples.

package/dist/client.d.ts

@@ -0,0 +1,16 @@
+import type { ClientSocketLike, RoomClient, RoomDefinition } from "./types";
+/**
+ * Binds a client socket to a room type and returns a typed room client.
+ *
+ * @example
+ * ```ts
+ * import { io } from "socket.io-client";
+ * import { createRoomClient } from "room-kit";
+ *
+ * const socket = io("http://127.0.0.1:3000");
+ * const client = createRoomClient(socket, chatRoomType);
+ * const joined = await client.join({ roomId: "team", roomKey: "secret", userName: "Ada" });
+ * ```
+ */
+export declare function createRoomClient<TRoom extends RoomDefinition<any>>(socket: ClientSocketLike, room: TRoom): RoomClient<TRoom>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAER,gBAAgB,EAUhB,UAAU,EACV,cAAc,EAKjB,MAAM,SAAS,CAAC;AAsCjB;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,CAAC,GAAG,CAAC,EAC9D,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,KAAK,GACZ,UAAU,CAAC,KAAK,CAAC,CA6CnB"}

package/dist/client.js

@@ -0,0 +1,317 @@
+const JOIN_EVENT = "room-kit:join";
+const LEAVE_EVENT = "room-kit:leave";
+const RPC_EVENT = "room-kit:rpc";
+const CLIENT_EVENT = "room-kit:client-event";
+const SERVER_EVENT = "room-kit:server-event";
+const PRESENCE_EVENT = "room-kit:presence";
+const PRESENCE_QUERY_EVENT = "room-kit:presence-query";
+const clientRegistries = new WeakMap();
+/**
+ * Binds a client socket to a room type and returns a typed room client.
+ *
+ * @example
+ * ```ts
+ * import { io } from "socket.io-client";
+ * import { createRoomClient } from "room-kit";
+ *
+ * const socket = io("http://127.0.0.1:3000");
+ * const client = createRoomClient(socket, chatRoomType);
+ * const joined = await client.join({ roomId: "team", roomKey: "secret", userName: "Ada" });
+ * ```
+ */
+export function createRoomClient(socket, room) {
+    return {
+        name: room.name,
+        get connection() {
+            const registry = getClientRegistry(socket);
+            return {
+                get current() {
+                    return registry.connectionState;
+                },
+                onChange(handler) {
+                    registry.connectionListeners.add(handler);
+                    return () => {
+                        registry.connectionListeners.delete(handler);
+                    };
+                },
+            };
+        },
+        join(payload) {
+            const registry = getClientRegistry(socket);
+            return emitAck(socket, JOIN_EVENT, {
+                roomType: room.name,
+                payload,
+            }).then((value) => {
+                const state = {
+                    name: room.name,
+                    roomId: value.roomId,
+                    memberId: value.memberId,
+                    roomProfile: value.roomProfile,
+                    presenceCurrent: value.presence,
+                    joinRequest: payload,
+                    eventListeners: new Map(),
+                    presenceListeners: new Set(),
+                };
+                registry.joinedRooms.set(makeJoinedRoomKey(room.name, value.roomId), state);
+                return createJoinedRoom(socket, state);
+            });
+        },
+    };
+}
+function createJoinedRoom(socket, state) {
+    const rpc = new Proxy({}, {
+        get(_target, key) {
+            if (typeof key !== "string") {
+                return undefined;
+            }
+            return (...args) => {
+                return emitAck(socket, RPC_EVENT, {
+                    roomType: state.name,
+                    roomId: state.roomId,
+                    name: key,
+                    args,
+                });
+            };
+        },
+    });
+    const emit = new Proxy({}, {
+        get(_target, key) {
+            if (typeof key !== "string") {
+                return undefined;
+            }
+            return (payload) => {
+                return emitAck(socket, CLIENT_EVENT, {
+                    roomType: state.name,
+                    roomId: state.roomId,
+                    name: key,
+                    payload,
+                });
+            };
+        },
+    });
+    const on = new Proxy({}, {
+        get(_target, key) {
+            if (typeof key !== "string") {
+                return undefined;
+            }
+            return (handler) => {
+                const handlers = state.eventListeners.get(key) ?? new Set();
+                handlers.add(handler);
+                state.eventListeners.set(key, handlers);
+                return () => {
+                    handlers.delete(handler);
+                    if (handlers.size === 0) {
+                        state.eventListeners.delete(key);
+                    }
+                };
+            };
+        },
+    });
+    const base = {
+        name: state.name,
+        roomId: state.roomId,
+        memberId: state.memberId,
+        roomProfile: state.roomProfile,
+        rpc,
+        emit,
+        on,
+        async leave() {
+            await emitAck(socket, LEAVE_EVENT, {
+                roomType: state.name,
+                roomId: state.roomId,
+            });
+            const registry = getClientRegistry(socket);
+            registry.joinedRooms.delete(makeJoinedRoomKey(state.name, state.roomId));
+        },
+    };
+    return new Proxy(base, {
+        get(target, key, receiver) {
+            if (key === "presence") {
+                return {
+                    get current() {
+                        return state.presenceCurrent;
+                    },
+                    onChange(handler) {
+                        state.presenceListeners.add(handler);
+                        return () => {
+                            state.presenceListeners.delete(handler);
+                        };
+                    },
+                    count() {
+                        return emitAck(socket, PRESENCE_QUERY_EVENT, {
+                            roomType: state.name,
+                            roomId: state.roomId,
+                            kind: "count",
+                        });
+                    },
+                    list(query = {}) {
+                        return emitAck(socket, PRESENCE_QUERY_EVENT, {
+                            roomType: state.name,
+                            roomId: state.roomId,
+                            kind: "list",
+                            ...query,
+                        });
+                    },
+                };
+            }
+            return Reflect.get(target, key, receiver);
+        },
+    });
+}
+function getClientRegistry(socket) {
+    const existing = clientRegistries.get(socket);
+    if (existing) {
+        return existing;
+    }
+    const created = {
+        serverHandlerInstalled: false,
+        presenceHandlerInstalled: false,
+        reconnectHandlerInstalled: false,
+        disconnectHandlerInstalled: false,
+        connectErrorHandlerInstalled: false,
+        reconnectAttemptHandlerInstalled: false,
+        reconnectErrorHandlerInstalled: false,
+        reconnectFailedHandlerInstalled: false,
+        hasConnectedOnce: false,
+        connectionState: "connecting",
+        connectionListeners: new Set(),
+        joinedRooms: new Map(),
+    };
+    installClientHandlers(socket, created);
+    clientRegistries.set(socket, created);
+    return created;
+}
+function installClientHandlers(socket, registry) {
+    if (!registry.serverHandlerInstalled) {
+        const onServerEvent = (frame) => {
+            const state = registry.joinedRooms.get(makeJoinedRoomKey(frame.roomType, frame.roomId));
+            if (!state) {
+                return;
+            }
+            const handlers = state.eventListeners.get(frame.name);
+            if (!handlers || handlers.size === 0) {
+                return;
+            }
+            const meta = {
+                ...frame.meta,
+                sentAt: new Date(frame.meta.sentAt),
+            };
+            for (const handler of handlers) {
+                handler(frame.payload, meta);
+            }
+        };
+        socket.on(SERVER_EVENT, onServerEvent);
+        registry.serverHandlerInstalled = true;
+    }
+    if (!registry.presenceHandlerInstalled) {
+        const onPresence = (frame) => {
+            const state = registry.joinedRooms.get(makeJoinedRoomKey(frame.roomType, frame.roomId));
+            if (!state) {
+                return;
+            }
+            state.presenceCurrent = frame.presence;
+            if (state.presenceCurrent === undefined) {
+                return;
+            }
+            for (const handler of state.presenceListeners) {
+                handler(state.presenceCurrent);
+            }
+        };
+        socket.on(PRESENCE_EVENT, onPresence);
+        registry.presenceHandlerInstalled = true;
+    }
+    if (!registry.reconnectHandlerInstalled) {
+        const onConnect = () => {
+            registry.hasConnectedOnce = true;
+            setConnectionState(registry, "connected");
+            void replayJoinedRooms(socket, registry);
+        };
+        socket.on("connect", onConnect);
+        registry.reconnectHandlerInstalled = true;
+    }
+    if (!registry.disconnectHandlerInstalled) {
+        const onDisconnect = () => {
+            setConnectionState(registry, "disconnected");
+        };
+        socket.on("disconnect", onDisconnect);
+        registry.disconnectHandlerInstalled = true;
+    }
+    if (!registry.connectErrorHandlerInstalled) {
+        const onConnectError = () => {
+            setConnectionState(registry, registry.hasConnectedOnce ? "reconnecting" : "connecting");
+        };
+        socket.on("connect_error", onConnectError);
+        registry.connectErrorHandlerInstalled = true;
+    }
+    if (!registry.reconnectAttemptHandlerInstalled) {
+        const onReconnectAttempt = () => {
+            setConnectionState(registry, "reconnecting");
+        };
+        socket.on("reconnect_attempt", onReconnectAttempt);
+        registry.reconnectAttemptHandlerInstalled = true;
+    }
+    if (!registry.reconnectFailedHandlerInstalled) {
+        const onReconnectFailed = () => {
+            setConnectionState(registry, "disconnected");
+        };
+        socket.on("reconnect_failed", onReconnectFailed);
+        registry.reconnectFailedHandlerInstalled = true;
+    }
+    if (!registry.reconnectErrorHandlerInstalled) {
+        const onReconnectError = () => {
+            setConnectionState(registry, "reconnecting");
+        };
+        socket.on("reconnect_error", onReconnectError);
+        registry.reconnectErrorHandlerInstalled = true;
+    }
+}
+async function replayJoinedRooms(socket, registry) {
+    for (const [key, state] of Array.from(registry.joinedRooms.entries())) {
+        try {
+            const value = await emitAck(socket, JOIN_EVENT, {
+                roomType: state.name,
+                payload: state.joinRequest,
+            });
+            state.roomId = value.roomId;
+            state.memberId = value.memberId;
+            state.roomProfile = value.roomProfile;
+            state.presenceCurrent = value.presence;
+            const newKey = makeJoinedRoomKey(state.name, value.roomId);
+            if (newKey !== key) {
+                registry.joinedRooms.delete(key);
+            }
+            registry.joinedRooms.set(newKey, state);
+        }
+        catch {
+            registry.joinedRooms.delete(key);
+        }
+    }
+}
+function makeJoinedRoomKey(name, roomId) {
+    return `${name}:${roomId}`;
+}
+function emitAck(socket, eventName, payload) {
+    return new Promise((resolve, reject) => {
+        socket.emit(eventName, payload, (result) => {
+            if (!result || typeof result !== "object") {
+                reject(new Error("Invalid acknowledgement payload"));
+                return;
+            }
+            if (result.ok) {
+                resolve(result.value);
+                return;
+            }
+            reject(new Error(result.error));
+        });
+    });
+}
+function setConnectionState(registry, next) {
+    if (registry.connectionState === next) {
+        return;
+    }
+    registry.connectionState = next;
+    for (const listener of registry.connectionListeners) {
+        listener(next);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ClientSafeError } from "./types";
+export { createRoomClient } from "./client";
+export { defineRoomType } from "./room";
+export { serveRoomType } from "./server";
+export type { ClientConnectionState, ClientSocketLike, EventMetaFor, JoinRequest, JoinedRoom, MemberProfileFor, PresenceListQuery, PresenceFor, PresencePageFor, PresencePolicy, RoomMemberSnapshot, RoomClient, RoomDefinition, RoomEvents, RoomProfileFor, RoomRpc, RoomSchema, ServerStateFor, RoomServerAdapter, RoomServerBroadcastApi, RoomServerHandle, RoomServerContext, RoomServerHandlers, RoomSnapshot, ServerAdmission, ServerSocketLike, VisibleMemberFor, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,YAAY,EACR,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,UAAU,EACV,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,SAAS,CAAC"}